Set-EntraBetaApplicationProxyApplication

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

Gör Set-EntraBetaApplicationProxyApplication att du kan ändra och ange konfigurationer för ett program i Microsoft Entra ID konfigurerat att använda ApplicationProxy.

Syntax

Default (Standard) 

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

Med Set-EntraBetaApplicationProxyApplication kan du ändra och ange andra inställningar för ett program i Microsoft Entra ID konfigurerat att använda ApplicationProxy. Ange ApplicationId parameter för att uppdatera programmet som konfigurerats för programproxy.

Exempel

Exempel 1: Uppdatera parametern ExternalUrl, InternalUrl, ExternalAuthenticationType och 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

I det här exemplet uppdateras ExternalUrlparametern , InternalUrl, ExternalAuthenticationTypeoch IsTranslateHostHeaderEnabled .

  • -ApplicationId parameter anger program-ID.
  • -ExternalUrl parameter anger den URL som använder för att komma åt programmet från ett privat nätverk utanför användaren.
  • -InternalUrl parameter anger den URL som använder för att komma åt programmet inifrån användarens privata nätverk.
  • -ExternalAuthenticationType parameter anger den externa autentiseringstypen.
  • -IsTranslateHostHeaderEnabled parameter anger översätter url:er i rubriker.

Exempel 2: Uppdatera parametern IsHttpOnlyCookieEnabled, IsSecureCookieEnabled och 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

Det här exemplet uppdaterar IsHttpOnlyCookieEnabled, IsSecureCookieEnabledoch IsPersistentCookieEnabled parametern.

  • -ApplicationId parameter anger program-ID.
  • -ExternalUrl parameter anger den URL som använder för att komma åt programmet från ett privat nätverk utanför användaren.
  • -InternalUrl parameter anger den URL som använder för att komma åt programmet inifrån användarens privata nätverk.
  • -ExternalAuthenticationType parameter anger den externa autentiseringstypen.
  • -IsHttpOnlyCookieEnabled parametern anger att programproxyn ska innehålla FLAGGAN HTTPOnly i HTTP-svarshuvuden.
  • -IsSecureCookieEnabled parameter anger programproxyn för att inkludera flaggan Säker i HTTP-svarshuvuden.
  • -IsTranslateHostHeaderEnabled parameter anger översätter url:er i rubriker.
  • -IsPersistentCookieEnabled parameter anger programproxy för att ange att dess åtkomstcookies inte upphör att gälla när webbläsaren stängs.

Exempel 3: Uppdatera parametern IsTranslateLinksInBodyEnabled, ApplicationServerTimeout och 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

Det här exemplet uppdaterar IsTranslateLinksInBodyEnabled, ApplicationServerTimeoutoch ConnectorGroupId parametern.

  • -ApplicationId parameter anger program-ID.
  • -ExternalUrl parameter anger den URL som använder för att komma åt programmet från ett privat nätverk utanför användaren.
  • -InternalUrl parameter anger den URL som använder för att komma åt programmet inifrån användarens privata nätverk.
  • -ConnectorGroupId parameter anger grupp-ID för anslutningsappen som tilldelats det här programmet.
  • -ApplicationServerTimeout parameter anger tidsgränsen för programservern som ska anges.
  • -ExternalAuthenticationType parameter anger den externa autentiseringstypen.
  • -IsTranslateHostHeaderEnabled parameter anger översätter url:er i rubriker.

Parametrar

-ApplicationId

Anger ett unikt program-ID för ett program i Microsoft Entra ID. Det här objectid kan hittas med hjälp av Get-EntraBetaApplication kommandot .

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Objekt-ID

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ApplicationServerTimeout

Anger tidsgränstypen för serverdelsservern. Ange det här värdet till Endast Lång om programmet är långsamt för att autentisera och ansluta.

Parameteregenskaper

Typ:ApplicationServerTimeoutEnum
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ConnectorGroupId

Ange ID för den anslutningsgrupp som du vill tilldela det här programmet. Du kan hitta det här värdet med hjälp Get-EntraBetaApplicationProxyConnectorGroup av kommandot . Anslutningsprogram bearbetar fjärråtkomsten till programmet och anslutningsgrupper hjälper dig att organisera anslutningsprogram och program efter region, nätverk eller syfte. Om du inte har skapat några anslutningsgrupper ännu tilldelas appen standard.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ExternalAuthenticationType

Hur proxy aplikácií verifierar användare innan de får åtkomst till ditt program. AadPreAuth: proxy aplikácií omdirigerar användare att logga in med Microsoft Entra ID, vilket autentiserar deras behörigheter för katalogen och programmet. Vi rekommenderar att du behåller det här alternativet som standard så att du kan dra nytta av Microsoft Entra ID säkerhetsfunktioner som villkorlig åtkomst och multifaktorautentisering. Gå igenom: Användarna behöver inte autentisera mot Microsoft Entra ID för att få åtkomst till programmet. Du kan fortfarande konfigurera autentiseringskrav från serverdelen.

Parameteregenskaper

Typ:ExternalAuthenticationTypeEnum
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ExternalUrl

Den adress som användarna går till för att få åtkomst till appen utanför nätverket.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-InternalUrl

Den URL som du använder för att komma åt programmet inifrån ditt privata nätverk. Du kan ange en specifik sökväg på backend-servern som du vill publicera, medan resten av servern är opublicerad. På så sätt kan du publicera olika webbplatser på samma server som olika program och ge varje webbplats sitt eget namn och sina egna åtkomstregler. Om du publicerar en sökväg, så se till att den innehåller alla bilder, skript och formatmallar som krävs för ditt program.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-IsHttpOnlyCookieEnabled

Tillåter att programproxyn inkluderar HTTPOnly-flaggan i HTTP-svarshuvuden. Den här flaggan ger extra säkerhetsfördelar, till exempel förhindrar den skriptning på klientsidan (CSS) från att kopiera eller ändra cookies.

Parameteregenskaper

Typ:System.Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-IsPersistentCookieEnabled

Tillåter att programproxyn anger att dess åtkomstcookies inte upphör att gälla när webbläsaren stängs. Beständigheten varar tills åtkomsttoken upphör att gälla eller tills användaren manuellt tar bort de beständiga cookies.

Parameteregenskaper

Typ:System.Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-IsSecureCookieEnabled

Tillåter att programproxyn inkluderar flaggan Säker i HTTP-svarshuvuden. Säkra cookies förbättrar säkerheten genom att överföra cookies via en "TLS"-skyddad kanal, till exempel HTTPS. TLS förhindrar cookieöverföring i klartext.

Parameteregenskaper

Typ:System.Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-IsTranslateHostHeaderEnabled

Om värdet är true översätter url:er i rubriker. Behåll det här värdet sant om inte programmet krävde det ursprungliga värdhuvudet i autentiseringsbegäran.

Parameteregenskaper

Typ:System.Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-IsTranslateLinksInBodyEnabled

Om värdet är true översätter url:er i brödtexten. Behåll det här värdet som Nej om du inte behöver hårdkodade HTML-länkar till andra lokala program och inte använder anpassade domäner.

Parameteregenskaper

Typ:System.Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.