Set-EntraBetaApplicationProxyApplication

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

Auf Set-EntraBetaApplicationProxyApplication diese Weise können Sie Konfigurationen für eine Anwendung in Microsoft Entra ID ändern und festlegen, die für die Verwendung von ApplicationProxy konfiguriert sind.

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>]

Beschreibung

Auf Set-EntraBetaApplicationProxyApplication diese Weise können Sie andere Einstellungen für eine Anwendung in Microsoft Entra ID ändern und festlegen, die für die Verwendung von ApplicationProxy konfiguriert sind. Geben Sie ApplicationId den Parameter zum Aktualisieren der Anwendung an, die für den Anwendungsproxy konfiguriert ist.

Beispiele

Beispiel 1: Aktualisieren des Parameters ExternalUrl, InternalUrl, ExternalAuthenticationType und 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

In diesem Beispiel wird aktualisiert ExternalUrl, InternalUrl, , ExternalAuthenticationTypeund IsTranslateHostHeaderEnabled Parameter.

  • -ApplicationId der Parameter gibt die Anwendungs-ID an.
  • -ExternalUrl der Parameter gibt die URL an, die für den Zugriff auf die Anwendung von außerhalb des privaten Netzwerks des Benutzers verwendet wird.
  • -InternalUrl der Parameter gibt die URL an, die für den Zugriff auf die Anwendung aus dem privaten Benutzernetzwerk verwendet wird.
  • -ExternalAuthenticationType der Parameter gibt den externen Authentifizierungstyp an.
  • -IsTranslateHostHeaderEnabled der Parameter gibt die übersetzten URLs in Kopfzeilen an.

Beispiel 2: Aktualisieren des Parameters IsHttpOnlyCookieEnabled, IsSecureCookieEnabled und 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 diesem Beispiel wird aktualisiert IsHttpOnlyCookieEnabled, IsSecureCookieEnabledund IsPersistentCookieEnabled parameter.

  • -ApplicationId der Parameter gibt die Anwendungs-ID an.
  • -ExternalUrl der Parameter gibt die URL an, die für den Zugriff auf die Anwendung von außerhalb des privaten Netzwerks des Benutzers verwendet wird.
  • -InternalUrl der Parameter gibt die URL an, die für den Zugriff auf die Anwendung aus dem privaten Benutzernetzwerk verwendet wird.
  • -ExternalAuthenticationType der Parameter gibt den externen Authentifizierungstyp an.
  • -IsHttpOnlyCookieEnabled der Parameter gibt den Anwendungsproxy an, der das HTTPOnly-Flag in HTTP-Antwortheader enthält.
  • -IsSecureCookieEnabled der Parameter gibt den Anwendungsproxy an, der das Sichere Flag in HTTP-Antwortheader einschließt.
  • -IsTranslateHostHeaderEnabled der Parameter gibt die übersetzten URLs in Kopfzeilen an.
  • -IsPersistentCookieEnabled Der Parameter gibt den Anwendungsproxy an, um seine Zugriffscookies so festzulegen, dass er nicht abläuft, wenn der Webbrowser geschlossen wird.

Beispiel 3: Aktualisieren des Parameters "IsTranslateLinksInBodyEnabled", "ApplicationServerTimeout" und "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

In diesem Beispiel wird aktualisiert IsTranslateLinksInBodyEnabled, ApplicationServerTimeoutund ConnectorGroupId parameter.

  • -ApplicationId der Parameter gibt die Anwendungs-ID an.
  • -ExternalUrl der Parameter gibt die URL an, die für den Zugriff auf die Anwendung von außerhalb des privaten Netzwerks des Benutzers verwendet wird.
  • -InternalUrl der Parameter gibt die URL an, die für den Zugriff auf die Anwendung aus dem privaten Benutzernetzwerk verwendet wird.
  • -ConnectorGroupId der Parameter gibt die Connector-Gruppen-ID an, die dieser Anwendung zugewiesen wurde.
  • -ApplicationServerTimeout der Parameter gibt das festzulegende Timeout des Anwendungsservers an.
  • -ExternalAuthenticationType der Parameter gibt den externen Authentifizierungstyp an.
  • -IsTranslateHostHeaderEnabled der Parameter gibt die übersetzten URLs in Kopfzeilen an.

Parameter

-ApplicationId

Gibt eine eindeutige Anwendungs-ID einer Anwendung in Microsoft Entra ID an. Diese Objekt-ID kann mithilfe des Get-EntraBetaApplication Befehls gefunden werden.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Objekt-ID

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ApplicationServerTimeout

Gibt den Timeouttyp des Back-End-Servers an. Legen Sie diesen Wert nur auf "Long" fest, wenn ihre Anwendung sich langsam authentifiziert und eine Verbindung herstellt.

Parametereigenschaften

Typ:ApplicationServerTimeoutEnum
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ConnectorGroupId

Geben Sie die ID der Connectorgruppe an, die Sie dieser Anwendung zuweisen möchten. Sie finden diesen Wert mithilfe des Get-EntraBetaApplicationProxyConnectorGroup Befehls. Connectors verarbeiten den Remotezugriff auf Ihre Anwendung, und Connectorgruppen helfen Ihnen, Connectors und Apps nach Region, Netzwerk oder Zweck zu organisieren. Wenn Sie noch keine Connectorgruppen erstellt haben, wird Ihre App standardmäßig zugewiesen.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ExternalAuthenticationType

Wie Anwendungsproxy Benutzer überprüft, bevor sie Zugriff auf Ihre Anwendung erhalten. AadPreAuth: Anwendungsproxy leitet Benutzer um, sich mit Microsoft Entra ID anzumelden, wodurch ihre Berechtigungen für das Verzeichnis und die Anwendung authentifiziert werden. Wir empfehlen, diese Option als Standard beizubehalten, damit Sie Microsoft Entra ID Sicherheitsfeatures wie bedingten Zugriff und mehrstufige Authentifizierung nutzen können. Übergeben: Benutzer müssen sich nicht für Microsoft Entra ID authentifizieren, um auf die Anwendung zuzugreifen. Sie können weiterhin Authentifizierungsanforderungen auf dem Back-End einrichten.

Parametereigenschaften

Typ:ExternalAuthenticationTypeEnum
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ExternalUrl

Die Adresse, zu der Ihre Benutzer wechseln, um von außerhalb Ihres Netzwerks auf die App zuzugreifen.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-InternalUrl

Die URL, die Sie für den Zugriff auf die Anwendung in Ihrem privaten Netzwerk verwenden. Sie können einen bestimmten Pfad auf dem Back-End-Server für die Veröffentlichung angeben, während der Rest des Servers nicht veröffentlicht wird. Auf diese Weise können Sie unterschiedliche Websites auf demselben Server als unterschiedliche Apps veröffentlichen und jeweils einen eigenen Namen und Zugriffsregeln vergeben. Stellen Sie beim Veröffentlichen eines Pfads sicher, dass er alle erforderlichen Bilder, Skripts und Stylesheets für Ihre Anwendung enthält.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-IsHttpOnlyCookieEnabled

Ermöglicht anwendungsproxys das HTTPOnly-Flag in HTTP-Antwortheader einzuschließen. Dieses Flag bietet zusätzliche Sicherheitsvorteile, z. B. wird das Kopieren oder Ändern von Cookies über ein clientseitiges Scripting (CSS) verhindert.

Parametereigenschaften

Typ:System.Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-IsPersistentCookieEnabled

Ermöglicht dem Anwendungsproxy, seine Zugriffscookies so festzulegen, dass er nicht abläuft, wenn der Webbrowser geschlossen wird. Cookies bleiben erhalten, bis das Zugriffstoken abläuft oder der Benutzer die persistenten Cookies manuell löscht.

Parametereigenschaften

Typ:System.Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-IsSecureCookieEnabled

Ermöglicht anwendungsproxys das Sichere Flag in HTTP-Antwortheader einzuschließen. Sichere Cookies verbessern die Sicherheit, indem Cookies über einen gesicherten "TLS"-Kanal wie HTTPS übertragen werden. TLS verhindert die Cookie-Übertragung in Klartext.

Parametereigenschaften

Typ:System.Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-IsTranslateHostHeaderEnabled

Wenn dieser Wert auf "true" festgelegt ist, werden URLs in Kopfzeilen übersetzt. Behalten Sie diesen Wert wahr, es sei denn, Ihre Anwendung benötigt den ursprünglichen Hostheader in der Authentifizierungsanforderung.

Parametereigenschaften

Typ:System.Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-IsTranslateLinksInBodyEnabled

Wenn dieser Wert auf "true" festgelegt ist, werden urls im Textkörper übersetzt. Behalten Sie diesen Wert als "Nein" bei, es sei denn, Sie müssen HTML-Links zu anderen lokalen Anwendungen hartcodieren und keine benutzerdefinierten Domänen verwenden.

Parametereigenschaften

Typ:System.Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.