Set-EntraBetaApplicationProxyApplication

Module:
Microsoft.Entra.Beta.Applications Module v1.3

Hiermee Set-EntraBetaApplicationProxyApplication kunt u configuraties voor een toepassing wijzigen en instellen in Microsoft Entra ID geconfigureerd voor het gebruik van ApplicationProxy.

Syntax

Default (Standaard) 

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

Hiermee Set-EntraBetaApplicationProxyApplication kunt u andere instellingen voor een toepassing wijzigen en instellen in Microsoft Entra ID geconfigureerd voor het gebruik van ApplicationProxy. Geef ApplicationId de parameter op voor het bijwerken van de toepassing die is geconfigureerd voor de toepassingsproxy.

Voorbeelden

Voorbeeld 1: De parameter ExternalUrl, InternalUrl, ExternalAuthenticationType en IsTranslateHostHeaderEnabled bijwerken

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

In dit voorbeeld worden de parameters ExternalUrlbijgewerkt, InternalUrlen ExternalAuthenticationTypeIsTranslateHostHeaderEnabled parameter.

  • -ApplicationId parameter geeft de toepassings-id.
  • -ExternalUrl parameter geeft de URL op die wordt gebruikt voor toegang tot de toepassing van buiten het privénetwerk van de gebruiker.
  • -InternalUrl parameter geeft de URL op die wordt gebruikt voor toegang tot de toepassing vanuit het privénetwerk van de gebruiker.
  • -ExternalAuthenticationType parameter geeft het externe verificatietype.
  • -IsTranslateHostHeaderEnabled parameter geeft de vertaal-URL's in headers.

Voorbeeld 2: Update IsHttpOnlyCookieEnabled, IsSecureCookieEnabled en parameter 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

In dit voorbeeld worden updates en IsPersistentCookieEnabledIsSecureCookieEnabledparameters bijgewerktIsHttpOnlyCookieEnabled.

  • -ApplicationId parameter geeft de toepassings-id.
  • -ExternalUrl parameter geeft de URL op die wordt gebruikt voor toegang tot de toepassing van buiten het privénetwerk van de gebruiker.
  • -InternalUrl parameter geeft de URL op die wordt gebruikt voor toegang tot de toepassing vanuit het privénetwerk van de gebruiker.
  • -ExternalAuthenticationType parameter geeft het externe verificatietype.
  • -IsHttpOnlyCookieEnabled parameter geeft de toepassingsproxy op om de HTTPOnly-vlag op te nemen in HTTP-antwoordheaders.
  • -IsSecureCookieEnabled parameter geeft de toepassingsproxy op om de secure vlag op te nemen in HTTP-antwoordheaders.
  • -IsTranslateHostHeaderEnabled parameter geeft de vertaal-URL's in headers.
  • -IsPersistentCookieEnabled parameter geeft de toepassingsproxy op om de toegangscookies zo in te stellen dat deze niet verlopen wanneer de webbrowser wordt gesloten.

Voorbeeld 3: De parameter IsTranslateLinksInBodyEnabled, ApplicationServerTimeout en ConnectorGroupId bijwerken

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

In dit voorbeeld worden updates en ConnectorGroupIdApplicationServerTimeoutparameters bijgewerktIsTranslateLinksInBodyEnabled.

  • -ApplicationId parameter geeft de toepassings-id.
  • -ExternalUrl parameter geeft de URL op die wordt gebruikt voor toegang tot de toepassing van buiten het privénetwerk van de gebruiker.
  • -InternalUrl parameter geeft de URL op die wordt gebruikt voor toegang tot de toepassing vanuit het privénetwerk van de gebruiker.
  • -ConnectorGroupId parameter geeft de connector groep-id die is toegewezen aan deze toepassing.
  • -ApplicationServerTimeout parameter geeft de time-out van de toepassingsserver op die moet worden ingesteld.
  • -ExternalAuthenticationType parameter geeft het externe verificatietype.
  • -IsTranslateHostHeaderEnabled parameter geeft de vertaal-URL's in headers.

Parameters

-ApplicationId

Hiermee geeft u een unieke toepassings-id van een toepassing in Microsoft Entra ID. Deze object-id kan worden gevonden met behulp van de Get-EntraBetaApplication opdracht.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ObjectId

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ApplicationServerTimeout

Hiermee geeft u het time-outtype van de back-endserver op. Stel deze waarde alleen in op Long als uw toepassing traag is om te verifiëren en verbinding te maken.

Parametereigenschappen

Type:ApplicationServerTimeoutEnum
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ConnectorGroupId

Geef de id op van de connectorgroep die u aan deze toepassing wilt toewijzen. U kunt deze waarde vinden met behulp van de Get-EntraBetaApplicationProxyConnectorGroup opdracht. Connectors verwerken de externe toegang tot uw toepassing en met connectorgroepen kunt u connectors en toepassingen indelen per regio, netwerk of doel. Als u nog geen connectorgroepen hebt gemaakt, wordt uw app toegewezen aan De standaardinstelling.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ExternalAuthenticationType

Hoe toepassingsproxy gebruikers verifieert voordat ze toegang krijgen tot uw toepassing. AadPreAuth: toepassingsproxy stuurt gebruikers om zich aan te melden met Microsoft Entra ID, waarmee hun machtigingen voor de directory en toepassing worden geverifieerd. We raden u aan deze optie als standaardoptie te gebruiken, zodat u kunt profiteren van Microsoft Entra ID beveiligingsfuncties zoals voorwaardelijke toegang en meervoudige verificatie. Pass through: gebruikers hoeven zich niet te verifiëren bij Microsoft Entra ID om toegang te krijgen tot de toepassing. U kunt nog steeds verificatievereisten op de backend instellen.

Parametereigenschappen

Type:ExternalAuthenticationTypeEnum
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ExternalUrl

Het adres waarnaar uw gebruikers gaan om toegang te krijgen tot de app van buiten uw netwerk.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-InternalUrl

De URL die u gebruikt voor toegang tot de toepassing vanuit uw privénetwerk. U kunt voor het publiceren een specifiek pad opgeven op de back-endserver, terwijl de rest van de server ongepubliceerd blijft. Op deze manier kunt u verschillende sites op dezelfde server als verschillende apps publiceren en elk daarvan een eigen naam en toegangsregels geven. Als u een pad publiceert, moet u ervoor zorgen dat dit alle benodigde afbeeldingen, scripts en style-sheets voor uw toepassing bevat.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-IsHttpOnlyCookieEnabled

Hiermee kan de toepassingsproxy de HTTPOnly-vlag opnemen in HTTP-antwoordheaders. Deze vlag biedt extra beveiligingsvoordelen, bijvoorbeeld, voorkomt dat scripts aan de clientzijde (CSS) de cookies kopiëren of wijzigen.

Parametereigenschappen

Type:System.Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-IsPersistentCookieEnabled

Hiermee kan de toepassingsproxy de toegangscookies zo instellen dat deze niet verlopen wanneer de webbrowser wordt gesloten. De persistentie duurt totdat het toegangstoken verloopt of totdat de gebruiker de permanente cookies handmatig verwijdert.

Parametereigenschappen

Type:System.Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-IsSecureCookieEnabled

Hiermee kan de toepassingsproxy de secure-vlag opnemen in HTTP-antwoordheaders. Beveiligde cookies verbeteren de beveiliging door cookies te verzenden via een beveiligd TLS-kanaal, zoals HTTPS. TLS voorkomt verzending van cookies in duidelijke tekst.

Parametereigenschappen

Type:System.Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-IsTranslateHostHeaderEnabled

Als deze optie is ingesteld op true, worden URL's omgezet in headers. Bewaar deze waarde waar, tenzij uw toepassing de oorspronkelijke hostheader in de verificatieaanvraag vereist.

Parametereigenschappen

Type:System.Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-IsTranslateLinksInBodyEnabled

Als deze optie is ingesteld op true, worden URL's omgezet in de hoofdtekst. Bewaar deze waarde als Nee, tenzij u in code vastgelegde HTML-koppelingen naar andere on-premises toepassingen moet gebruiken en geen aangepaste domeinen gebruikt.

Parametereigenschappen

Type:System.Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.