Set-EntraBetaApplicationProxyApplication

Módulo:
Microsoft.Entra.Beta.Applications Module v1.3

Permite Set-EntraBetaApplicationProxyApplication modificar e definir configurações para um aplicativo em Microsoft Entra ID configurado para usar o ApplicationProxy.

Sintaxe

Default (Default) 

Set-EntraBetaApplicationProxyApplication

    -ApplicationId <String>
    [-ExternalUrl <String>]
    [-InternalUrl <String>]
    [-ExternalAuthenticationType <ExternalAuthenticationTypeEnum>]
    [-IsTranslateHostHeaderEnabled <Boolean>]
    [-IsHttpOnlyCookieEnabled <Boolean>]
    [-IsSecureCookieEnabled <Boolean>]
    [-IsPersistentCookieEnabled <Boolean>]
    [-IsTranslateLinksInBodyEnabled <Boolean>]
    [-ApplicationServerTimeout <ApplicationServerTimeoutEnum>]
    [-ConnectorGroupId <String>]
    [<CommonParameters>]

Description

Permite Set-EntraBetaApplicationProxyApplication modificar e definir outras configurações para um aplicativo em Microsoft Entra ID configurado para usar o ApplicationProxy. Especifique ApplicationId o parâmetro para atualizar o aplicativo configurado para o proxy de aplicativo.

Exemplos

Exemplo 1: atualizar o parâmetro ExternalUrl, InternalUrl, ExternalAuthenticationType e IsTranslateHostHeaderEnabled

Connect-Entra -Scopes 'Directory.ReadWrite.All'
$params = @{
    ApplicationId                = 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb'
    ExternalUrl                  = 'https://finance-awcycles.msappproxy.net/'
    InternalUrl                  = 'http://finance/'
    ExternalAuthenticationType   = 'AadPreAuthentication'
    IsTranslateHostHeaderEnabled = $false
}
Set-EntraBetaApplicationProxyApplication @params

ObjectId                                 : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
externalAuthenticationType               : aadPreAuthentication
applicationServerTimeout                 : Long
externalUrl                              : https://testp-m365x99297270.msappproxy.net/
internalUrl                              : https://testp.com/
isTranslateHostHeaderEnabled             : False
isTranslateLinksInBodyEnabled            : False
isOnPremPublishingEnabled                : True
verifiedCustomDomainCertificatesMetadata :
verifiedCustomDomainKeyCredential        :
verifiedCustomDomainPasswordCredential   :
singleSignOnSettings                     : @{singleSignOnMode=none; kerberosSignOnSettings=}
isHttpOnlyCookieEnabled                  : False
isSecureCookieEnabled                    : False
isPersistentCookieEnabled                : False

Este exemplo de atualizaçãoExternalUrl, InternalUrle ExternalAuthenticationTypeIsTranslateHostHeaderEnabled parâmetro.

  • -ApplicationId o parâmetro especifica a ID do aplicativo.
  • -ExternalUrl O parâmetro especifica a URL que usa para acessar o aplicativo de uma rede privada de usuário externa.
  • -InternalUrl O parâmetro especifica a URL que usa para acessar o aplicativo de dentro da rede privada do usuário.
  • -ExternalAuthenticationType o parâmetro especifica o tipo de autenticação externa.
  • -IsTranslateHostHeaderEnabled o parâmetro especifica as URLs traduzidas em cabeçalhos.

Exemplo 2: atualizar o parâmetro IsHttpOnlyCookieEnabled, IsSecureCookieEnabled e IsPersistentCookieEnabled

Connect-Entra -Scopes 'Directory.ReadWrite.All'
$params = @{
    ApplicationId                = 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb'
    ExternalUrl                  = 'https://finance-awcycles.msappproxy.net/'
    InternalUrl                  = 'http://finance/'
    ExternalAuthenticationType   = 'AadPreAuthentication'
    IsTranslateHostHeaderEnabled = $false
    IsHttpOnlyCookieEnabled      = $false
    IsSecureCookieEnabled        = $false
    IsPersistentCookieEnabled    = $false
}
Set-EntraBetaApplicationProxyApplication @params

ObjectId                                 : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
externalAuthenticationType               : aadPreAuthentication
applicationServerTimeout                 : Long
externalUrl                              : https://testp-contoso.msappproxy.net/
internalUrl                              : https://testp.com/
isTranslateHostHeaderEnabled             : False
isTranslateLinksInBodyEnabled            : False
isOnPremPublishingEnabled                : True
verifiedCustomDomainCertificatesMetadata :
verifiedCustomDomainKeyCredential        :
verifiedCustomDomainPasswordCredential   :
singleSignOnSettings                     : @{singleSignOnMode=none; kerberosSignOnSettings=}
isHttpOnlyCookieEnabled                  : False
isSecureCookieEnabled                    : False
isPersistentCookieEnabled                : False

Este exemplo de atualização IsHttpOnlyCookieEnablede IsSecureCookieEnabledIsPersistentCookieEnabled parâmetro.

  • -ApplicationId o parâmetro especifica a ID do aplicativo.
  • -ExternalUrl O parâmetro especifica a URL que usa para acessar o aplicativo de uma rede privada de usuário externa.
  • -InternalUrl O parâmetro especifica a URL que usa para acessar o aplicativo de dentro da rede privada do usuário.
  • -ExternalAuthenticationType o parâmetro especifica o tipo de autenticação externa.
  • -IsHttpOnlyCookieEnabled o parâmetro especifica o proxy de aplicativo para incluir o sinalizador HTTPOnly em cabeçalhos de resposta HTTP.
  • -IsSecureCookieEnabled o parâmetro especifica o proxy de aplicativo para incluir o sinalizador de segurança em cabeçalhos de resposta HTTP.
  • -IsTranslateHostHeaderEnabled o parâmetro especifica as URLs traduzidas em cabeçalhos.
  • -IsPersistentCookieEnabled O parâmetro especifica o proxy de aplicativo para definir seus cookies de acesso para não expirarem quando o navegador da Web for fechado.

Exemplo 3: atualizar o parâmetro IsTranslateLinksInBodyEnabled, ApplicationServerTimeout e ConnectorGroupId

Connect-Entra -Scopes 'Directory.ReadWrite.All'
$params = @{
    ApplicationId                = 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb'
    ExternalUrl                  = 'https://finance-awcycles.msappproxy.net/'
    InternalUrl                  = 'http://finance/'
    ExternalAuthenticationType   = 'AadPreAuthentication'
    IsTranslateHostHeaderEnabled = $false
    ApplicationServerTimeout     = Long
    ConnectorGroupId             = 'bbbbbbbb-1111-2222-3333-cccccccccccc'
}
Set-EntraBetaApplicationProxyApplication @params

ObjectId                                 : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
externalAuthenticationType               : aadPreAuthentication
applicationServerTimeout                 : Long
externalUrl                              : https://testp-contoso.msappproxy.net/
internalUrl                              : https://testp.com/
isTranslateHostHeaderEnabled             : False
isTranslateLinksInBodyEnabled            : False
isOnPremPublishingEnabled                : True
verifiedCustomDomainCertificatesMetadata :
verifiedCustomDomainKeyCredential        :
verifiedCustomDomainPasswordCredential   :
singleSignOnSettings                     : @{singleSignOnMode=none; kerberosSignOnSettings=}
isHttpOnlyCookieEnabled                  : False
isSecureCookieEnabled                    : False
isPersistentCookieEnabled                : False

Este exemplo de atualização IsTranslateLinksInBodyEnablede ApplicationServerTimeoutConnectorGroupId parâmetro.

  • -ApplicationId o parâmetro especifica a ID do aplicativo.
  • -ExternalUrl O parâmetro especifica a URL que usa para acessar o aplicativo de uma rede privada de usuário externa.
  • -InternalUrl O parâmetro especifica a URL que usa para acessar o aplicativo de dentro da rede privada do usuário.
  • -ConnectorGroupId o parâmetro especifica a ID do grupo conector atribuída a este aplicativo.
  • -ApplicationServerTimeout o parâmetro especifica o tempo limite do servidor de aplicativos a ser definido.
  • -ExternalAuthenticationType o parâmetro especifica o tipo de autenticação externa.
  • -IsTranslateHostHeaderEnabled o parâmetro especifica as URLs traduzidas em cabeçalhos.

Parâmetros

-ApplicationId

Especifica uma ID de aplicativo exclusiva de um aplicativo no Microsoft Entra ID. Essa objectid pode ser encontrada usando o Get-EntraBetaApplication comando.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:IdentificadorDeObjeto

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ApplicationServerTimeout

Especifica o tipo de tempo limite do servidor de back-end. Defina esse valor como Long somente se o aplicativo estiver lento para autenticar e se conectar.

Propriedades do parâmetro

Tipo:ApplicationServerTimeoutEnum
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ConnectorGroupId

Forneça a ID do grupo conector que você deseja atribuir a este aplicativo. Você pode encontrar esse valor usando o Get-EntraBetaApplicationProxyConnectorGroup comando. Conectores processam o acesso remoto ao seu aplicativo e o ajudam a organizar conectores e aplicativos por região, rede ou finalidade. Se você ainda não tiver nenhum grupo de conectores criado, seu aplicativo será atribuído ao Padrão.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ExternalAuthenticationType

Como Proxy de Aplicativo verifica os usuários antes de dar-lhes acesso ao seu aplicativo. AadPreAuth: Proxy de Aplicativo redireciona os usuários para entrar com Microsoft Entra ID, o que autentica suas permissões para o diretório e o aplicativo. É recomendável manter essa opção como padrão, para que você possa aproveitar Microsoft Entra ID recursos de segurança, como acesso condicional e autenticação multifator. Passagem: os usuários não precisam se autenticar em Microsoft Entra ID para acessar o aplicativo. Você ainda pode configurar os requisitos de autenticação no back-end.

Propriedades do parâmetro

Tipo:ExternalAuthenticationTypeEnum
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ExternalUrl

O endereço que seus usuários acessam para acessar o aplicativo de fora da sua rede.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-InternalUrl

A URL que você usa para acessar o aplicativo de dentro de sua rede privada. Você pode fornecer um caminho específico no servidor back-end para publicar, enquanto o restante do servidor não é publicado. Assim, você pode publicar sites diferentes no mesmo servidor como diferentes aplicativos, e dar a cada um deles seu próprio nome e suas regras de acesso. Se você publicar um caminho, verifique se ele inclui todas as imagens, scripts e folhas de estilo necessários para seu aplicativo.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IsHttpOnlyCookieEnabled

Permite que o proxy de aplicativo inclua o sinalizador HTTPOnly em cabeçalhos de resposta HTTP. Esse sinalizador oferece benefícios de segurança adicionais, por exemplo, impede que o script CSS (do lado do cliente) copie ou modifique os cookies.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IsPersistentCookieEnabled

Permite que o proxy de aplicativo defina seus cookies de acesso para não expirarem quando o navegador da Web for fechado. A persistência dura até que o token de acesso expire ou até que o usuário exclua manualmente os cookies persistentes.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IsSecureCookieEnabled

Permite que o proxy de aplicativo inclua o sinalizador De segurança em cabeçalhos de resposta HTTP. Os Cookies Seguros aprimoram a segurança transmitindo cookies em um canal protegido "TLS", como HTTPS. O TLS impede a transmissão de cookie em texto claro.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IsTranslateHostHeaderEnabled

Se definido como true, converte urls em cabeçalhos. Mantenha esse valor verdadeiro, a menos que seu aplicativo exija o cabeçalho do host original na solicitação de autenticação.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IsTranslateLinksInBodyEnabled

Se definido como true, converte urls no corpo. Mantenha esse valor como Não, a menos que você precise codificar links HTML para outros aplicativos locais e não use domínios personalizados.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.