New-EntraBetaApplicationProxyApplication

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

O New-EntraBetaApplicationProxyApplication cmdlet cria uma nova aplicação configurada para Proxy de Aplicações no Microsoft Entra ID.

Sintaxe

Default (Predefinição) 

New-EntraBetaApplicationProxyApplication

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

Descrição

O New-EntraBetaApplicationProxyApplication cmdlet cria uma nova aplicação configurada para Proxy de Aplicações no Microsoft Entra ID. Para garantir que esta aplicação é utilizável, certifique-se também de atribuir utilizadores e configurar o SSO se necessário. Sem especificar um ConnectorGroupId, esta aplicação usa por defeito o Default grupo de conectores no seu inquilino.

Exemplos

Exemplo 1: Criar uma nova aplicação apenas com as definições básicas exigidas e o domínio predefinido para aplicações

Connect-Entra -Scopes 'Directory.ReadWrite.All'
$params = @{
    DisplayName = 'Finance Tracker'
    ExternalUrl = 'https://finance-awcycles.msappproxy.net/'
    InternalUrl = 'http://finance/'
}
New-EntraBetaApplicationProxyApplication @params


ObjectId                                 : bbbbbbbb-1111-2222-3333-cccccccccccc
externalAuthenticationType               :
applicationServerTimeout                 :
externalUrl                              : https://finance-awcycles.msappproxy.net/
internalUrl                              : http://finance/
isTranslateHostHeaderEnabled             : False
isTranslateLinksInBodyEnabled            : False
isOnPremPublishingEnabled                : True
verifiedCustomDomainCertificatesMetadata :
verifiedCustomDomainKeyCredential        :
verifiedCustomDomainPasswordCredential   :
singleSignOnSettings                     : @{singleSignOnMode=none; kerberosSignOnSettings=}
isHttpOnlyCookieEnabled                  : False
isSecureCookieEnabled                    : False
isPersistentCookieEnabled                : False

Este exemplo cria uma nova aplicação apenas com as definições básicas necessárias e o domínio predefinido para as aplicações.

  • -DisplayName O parâmetro especifica o nome de exibição da nova aplicação.
  • -ExternalUrl parâmetro especifica a URL que usa para aceder à aplicação a partir da rede privada externa do utilizador.
  • -InternalUrl parameter especifica a URL que é usada para aceder à aplicação a partir da rede privada do utilizador.

Exemplo 2: Criar uma nova aplicação com os parâmetros ApplicationServerTimeout e ExternalAuthenticationType

Connect-Entra -Scopes 'Directory.ReadWrite.All'
$params = @{
    DisplayName = 'Finance Tracker'
    ExternalUrl = 'https://finance-awcycles.msappproxy.net/'
    InternalUrl = 'http://finance/'
    ApplicationServerTimeout = Long
    ExternalAuthenticationType = 'aadPreAuthentication'
}
New-EntraBetaApplicationProxyApplication @params

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

Este exemplo cria uma nova aplicação com ApplicationServerTimeout um ExternalAuthenticationType parâmetro.

  • -DisplayName O parâmetro especifica o nome de exibição da nova aplicação.
  • -ExternalUrl parâmetro especifica a URL que usa para aceder à aplicação a partir da rede privada externa do utilizador.
  • -InternalUrl parameter especifica a URL que é usada para aceder à aplicação a partir da rede privada do utilizador.
  • -ApplicationServerTimeout O parâmetro especifica o timeout do servidor da aplicação para definir.
  • -ExternalAuthenticationType O parâmetro especifica o tipo de autenticação externa.

Exemplo 3: Criar uma nova aplicação com os parâmetros IsHttpOnlyCookieEnabled, IsSecureCookieEnabled, IsTranslateLinksInBodyEnabled e parâmetros ConnectorGroupId

Connect-Entra -Scopes 'Directory.ReadWrite.All'
$params = @{
    DisplayName = 'Finance Tracker'
    ExternalUrl = 'https://finance-awcycles.msappproxy.net/'
    InternalUrl = 'http://finance/'
    IsHttpOnlyCookieEnabled = $false
    IsSecureCookieEnabled = $false
    IsPersistentCookieEnabled = $false
    IsTranslateLinksInBodyEnabled = $false
    ConnectorGroupId = 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb'
}
New-EntraBetaApplicationProxyApplication @params

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

Este exemplo cria uma nova aplicação com IsHttpOnlyCookieEnabled, IsSecureCookieEnabled, IsTranslateLinksInBodyEnabled, e ConnectorGroupId parâmetro.

  • -DisplayName O parâmetro especifica o nome de exibição da nova aplicação.
  • -ExternalUrl parâmetro especifica a URL que usa para aceder à aplicação a partir da rede privada externa do utilizador.
  • -InternalUrl parameter especifica a URL que é usada para aceder à aplicação a partir da rede privada do utilizador.
  • -ConnectorGroupId parâmetro especifica o ID do grupo Connector atribuído a esta aplicação.
  • -IsHttpOnlyCookieEnabled o parâmetro especifica que o proxy da aplicação inclui a flag HTTPOnly nos cabeçalhos de resposta HTTP.
  • -IsSecureCookieEnabled o parâmetro especifica o proxy da aplicação para incluir a flag Secure nos cabeçalhos de resposta HTTP.
  • -IsPersistentCookieEnabled O parâmetro especifica o proxy da aplicação para definir os seus cookies de acesso para não expirarem quando o navegador web estiver fechado.
  • -IsTranslateLinksInBodyEnabled parâmetro especifica que traduz URLs no corpo.

Parâmetros

-ApplicationServerTimeout

Defina este valor para Long apenas se a sua aplicação demorar a autenticar-se e a ligar-se.

Propriedades dos parâmetros

Tipo:ApplicationServerTimeoutEnum
Valor predefinido:None
Valores aceites:Default, Long
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ConnectorGroupId

Forneça o ID do grupo Connector que pretende ser atribuído a esta aplicação. Pode encontrar este valor usando o Get-EntraBetaApplicationProxyConnectorGroup comando. Os conectores processam o acesso remoto ao seu aplicativo e os grupos de conectores ajudam a organizar conectores e aplicativos por região, rede ou finalidade. Se ainda não tiver grupos de conectores criados, a sua aplicação está atribuída ao padrão.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-DisplayName

O nome de exibição da nova aplicação.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ExternalAuthenticationType

Como o Proxy de Aplicações verifica os utilizadores antes de lhes dar acesso à sua aplicação. AadPreAuthentication: O Proxy de Aplicações redireciona os utilizadores para iniciar sessão com o Microsoft Entra ID, que autentica as suas permissões para o diretório e a aplicação. Recomendamos manter esta opção como padrão, para que possa tirar partido das funcionalidades de segurança do Microsoft Entra ID, como acesso condicional e autenticação multifator. Passthrough: Os utilizadores não precisam de se autenticar com o Microsoft Entra ID para aceder à aplicação. Você ainda pode configurar requisitos de autenticação no back-end.

Propriedades dos parâmetros

Tipo:ExternalAuthenticationTypeEnum
Valor predefinido:None
Valores aceites:AadPreAuthentication, Passthru
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ExternalUrl

O endereço para onde os teus utilizadores vão para aceder à aplicação a partir de fora da tua rede.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-InternalUrl

O URL que usas para aceder à aplicação a partir da tua rede privada. Pode fornecer um caminho específico no servidor de back-end para publicação, enquanto o resto do servidor não é publicado. Dessa forma, você pode publicar sites diferentes no mesmo servidor como aplicativos diferentes e dar a cada um seu próprio nome e regras de acesso. Se publicar um caminho, certifique-se de que inclui todas as imagens, scripts e folhas de estilo necessários para a sua aplicação.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-IsHttpOnlyCookieEnabled

O Yes permite que o proxy da aplicação inclua a bandeira HTTPOnly nos cabeçalhos de resposta HTTP. Esse sinalizador fornece benefícios extras de segurança, por exemplo, impede que scripts do lado do cliente (CSS) copiem ou modifiquem os cookies.

Propriedades dos parâmetros

Tipo:System.Boolean
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-IsPersistentCookieEnabled

O Yes permite que o proxy da aplicação defina os seus cookies de acesso para não expirarem quando o navegador está fechado. A persistência dura até que o token de acesso expire, ou até que o usuário exclua manualmente os cookies persistentes.

Propriedades dos parâmetros

Tipo:System.Boolean
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-IsSecureCookieEnabled

O Yes permite que o proxy da aplicação inclua a flag Secure nos cabeçalhos de resposta HTTP. Os cookies seguros aumentam a segurança ao transmitir cookies através de um canal seguro TLS, como HTTPS. O TLS impede a transmissão de cookies em texto não criptografado.

Propriedades dos parâmetros

Tipo:System.Boolean
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-IsTranslateHostHeaderEnabled

Se definido como verdadeiro, traduz URLs nos cabeçalhos. Mantenha este valor verdadeiro, a menos que a sua aplicação tenha exigido o cabeçalho original do host no pedido de autenticação.

Propriedades dos parâmetros

Tipo:System.Boolean
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-IsTranslateLinksInBodyEnabled

Se definido como verdadeiro, traduz URLs no corpo. Mantém este valor como Não a menos que tenhas de ligar HTML fixo para outras aplicações on-premises e não uses domínios personalizados.

Propriedades dos parâmetros

Tipo:System.Boolean
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Entradas

System.String

System.Nullable'1[[Microsoft. Open.MSGraph.Model.ApplicationProxyApplicationObject+ExternalAuthenticationTypeEnum, Microsoft. Open.MS.GraphV10.Client, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null]] System.Nullable'1[[System. Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]] System.Nullable'1[[Microsoft. Open.MSGraph.Model.ApplicationProxyApplicationObject+ApplicationServerTimeoutEnum, Microsoft. Open.MS.GraphV10.Client, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null]]

Saídas

System.Object