Set-EntraBetaApplicationProxyApplication

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

Set-EntraBetaApplicationProxyApplication permite modificar y establecer configuraciones para una aplicación en Microsoft Entra ID configuradas para usar ApplicationProxy.

Sintaxis

Default (valor predeterminado) 

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

Set-EntraBetaApplicationProxyApplication permite modificar y establecer otras opciones para una aplicación en Microsoft Entra ID configuradas para usar ApplicationProxy. Especifique ApplicationId el parámetro para actualizar la aplicación configurada para el proxy de aplicación.

Ejemplos

Ejemplo 1: Actualizar el 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

En este ejemplo se actualiza ExternalUrlel parámetro , InternalUrl, ExternalAuthenticationTypey IsTranslateHostHeaderEnabled .

  • -ApplicationId el parámetro especifica el identificador de aplicación.
  • -ExternalUrl el parámetro especifica la dirección URL que usa para acceder a la aplicación desde una red privada de usuario externa.
  • -InternalUrl el parámetro especifica la dirección URL que usa para acceder a la aplicación desde dentro de la red privada del usuario.
  • -ExternalAuthenticationType el parámetro especifica el tipo de autenticación externo.
  • -IsTranslateHostHeaderEnabled el parámetro especifica las direcciones URL de traducción en encabezados.

Ejemplo 2: Actualizar el 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

En este ejemplo se actualiza IsHttpOnlyCookieEnabled, IsSecureCookieEnabledy IsPersistentCookieEnabled el parámetro .

  • -ApplicationId el parámetro especifica el identificador de aplicación.
  • -ExternalUrl el parámetro especifica la dirección URL que usa para acceder a la aplicación desde una red privada de usuario externa.
  • -InternalUrl el parámetro especifica la dirección URL que usa para acceder a la aplicación desde dentro de la red privada del usuario.
  • -ExternalAuthenticationType el parámetro especifica el tipo de autenticación externo.
  • -IsHttpOnlyCookieEnabled el parámetro especifica el proxy de aplicación para incluir la marca HTTPOnly en los encabezados de respuesta HTTP.
  • -IsSecureCookieEnabled el parámetro especifica el proxy de aplicación para incluir la marca Secure en los encabezados de respuesta HTTP.
  • -IsTranslateHostHeaderEnabled el parámetro especifica las direcciones URL de traducción en encabezados.
  • -IsPersistentCookieEnabled el parámetro especifica el proxy de aplicación para establecer sus cookies de acceso para que no expiren cuando se cierra el explorador web.

Ejemplo 3: Actualizar el parámetro IsTranslateLinksInBodyEnabled, ApplicationServerTimeout y 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

En este ejemplo se actualiza IsTranslateLinksInBodyEnabled, ApplicationServerTimeouty ConnectorGroupId el parámetro .

  • -ApplicationId el parámetro especifica el identificador de aplicación.
  • -ExternalUrl el parámetro especifica la dirección URL que usa para acceder a la aplicación desde una red privada de usuario externa.
  • -InternalUrl el parámetro especifica la dirección URL que usa para acceder a la aplicación desde dentro de la red privada del usuario.
  • -ConnectorGroupId el parámetro especifica el identificador de grupo del conector que se asignó a esta aplicación.
  • -ApplicationServerTimeout parameter especifica el tiempo de espera del servidor de aplicaciones que se va a establecer.
  • -ExternalAuthenticationType el parámetro especifica el tipo de autenticación externo.
  • -IsTranslateHostHeaderEnabled el parámetro especifica las direcciones URL de traducción en encabezados.

Parámetros

-ApplicationId

Especifica un identificador de aplicación único de una aplicación en Microsoft Entra ID. Este objectid se puede encontrar mediante el Get-EntraBetaApplication comando .

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ObjectId (identificador de objeto)

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ApplicationServerTimeout

Especifica el tipo de tiempo de espera del servidor back-end. Establezca este valor en Long solo si la aplicación es lenta para autenticarse y conectarse.

Propiedades de parámetro

Tipo:ApplicationServerTimeoutEnum
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ConnectorGroupId

Proporcione el identificador del grupo conector que desea asignar a esta aplicación. Puede encontrar este valor mediante el Get-EntraBetaApplicationProxyConnectorGroup comando . Los conectores procesan el acceso remoto a la aplicación, y los grupos de conectores le ayudan a organizar los conectores y las aplicaciones por región, red o finalidad. Si aún no tiene ningún grupo de conectores creado, la aplicación se asigna a Default.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ExternalAuthenticationType

Cómo Application Proxy comprueba a los usuarios antes de concederles acceso a la aplicación. AadPreAuth: Application Proxy redirige a los usuarios para iniciar sesión con Microsoft Entra ID, que autentica sus permisos para el directorio y la aplicación. Se recomienda mantener esta opción como predeterminada, para que pueda aprovechar las ventajas de las características de seguridad de Microsoft Entra ID, como el acceso condicional y la autenticación multifactor. Paso a través: los usuarios no tienen que autenticarse en Microsoft Entra ID para acceder a la aplicación. Esto no impide que pueda configurar los requisitos de autenticación en el back-end.

Propiedades de parámetro

Tipo:ExternalAuthenticationTypeEnum
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ExternalUrl

La dirección a la que van los usuarios para acceder a la aplicación desde fuera de la red.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-InternalUrl

Dirección URL que se usa para acceder a la aplicación desde dentro de la red privada. Puede especificar una ruta específica en el servidor backend para publicar, mientras que el resto del servidor permanece sin publicar. De esta forma, puede publicar sitios diferentes en el mismo servidor como aplicaciones diferentes y dar a cada uno un nombre y unas reglas de acceso propios. Si publica una ruta de acceso, asegúrese de que incluye todas las imágenes, los scripts y las hojas de estilos necesarias para la aplicación.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IsHttpOnlyCookieEnabled

Permite que el proxy de aplicación incluya la marca HTTPOnly en los encabezados de respuesta HTTP. Esta marca proporciona ventajas de seguridad adicionales; por ejemplo, evita que el scripting del cliente (CSS) copie o modifique las cookies.

Propiedades de parámetro

Tipo:System.Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IsPersistentCookieEnabled

Permite que el proxy de aplicación establezca sus cookies de acceso para que no expiren cuando se cierre el explorador web. La persistencia dura hasta que expire el token de acceso o hasta que el usuario elimine manualmente las cookies persistentes.

Propiedades de parámetro

Tipo:System.Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IsSecureCookieEnabled

Permite que el proxy de aplicación incluya la marca Secure en los encabezados de respuesta HTTP. Las cookies seguras mejoran la seguridad mediante la transmisión de cookies a través de un canal protegido "TLS", como HTTPS. TLS impide la transmisión de cookies en texto no cifrado.

Propiedades de parámetro

Tipo:System.Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IsTranslateHostHeaderEnabled

Si se establece en true, traduce las direcciones URL en los encabezados. Mantenga este valor true a menos que la aplicación requiera el encabezado de host original en la solicitud de autenticación.

Propiedades de parámetro

Tipo:System.Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IsTranslateLinksInBodyEnabled

Si se establece en true, traduce las direcciones URL en el cuerpo. Mantenga este valor como No a menos que tenga que codificar vínculos HTML codificados a otras aplicaciones locales y no use dominios personalizados.

Propiedades de parámetro

Tipo:System.Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.