Freigeben über

New-AzureADApplicationProxyApplication

Modul:
AzureAD Module

Mit dem Cmdlet New-AzureADApplicationProxyApplication wird eine neue Anwendung erstellt, die für den Anwendungsproxy in Azure Active Directory konfiguriert ist.

Syntax

Default (Standardwert) 

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

Beschreibung

Mit dem Cmdlet New-AzureADApplicationProxyApplication wird eine neue Anwendung erstellt, die für den Anwendungsproxy in Azure Active Directory konfiguriert ist. Um sicherzustellen, dass diese Anwendung verwendbar ist, stellen Sie bitte auch sicher, dass Sie Benutzer zuweisen und SSO konfigurieren, falls erforderlich. Beachten Sie, dass diese Anwendung ohne Angabe einer ConnectorGroupId standardmäßig die Standardconnectorgruppe in Ihrem Mandanten verwendet.

Beispiele

Beispiel 1

PS C:\> New-AzureADApplicationProxyApplication -DisplayName "Finance Tracker" -ExternalUrl "https://finance-awcycles.msappproxy.net/" -InternalUrl "http://finance/"


ExternalAuthenticationType               : AadPreAuthentication
ApplicationServerTimeout                 : Default
ExternalUrl                              : https://finance-awcycles.msappproxy.net/
InternalUrl                              : http://finance/
IsTranslateHostHeaderEnabled             : True
IsTranslateLinksInBodyEnabled            : False
IsOnPremPublishingEnabled                : True
VerifiedCustomDomainCertificatesMetadata :
VerifiedCustomDomainKeyCredential        :
VerifiedCustomDomainPasswordCredential   :
SingleSignOnSettings                     :

Beispiel 1: Erstellen einer neuen Anwendung mit nur den erforderlichen Grundeinstellungen und der Standarddomäne für Anwendungen.

Beispiel 2

PS C:\> New-AzureADApplicationProxyApplication -DisplayName "HR Resources" -ExternalUrl "https://hr.adventure-works.com/" -InternalUrl "http://hr.adventure-works.com/" -ApplicationServerTimeout Long


ExternalAuthenticationType               : AadPreAuthentication
ApplicationServerTimeout                 : Long
ExternalUrl                              : https://hr.adventure-works.com/
InternalUrl                              : http://hr.adventure-works.com/
IsTranslateHostHeaderEnabled             : True
IsTranslateLinksInBodyEnabled            : False
IsOnPremPublishingEnabled                : True
VerifiedCustomDomainCertificatesMetadata : class OnPremisesPublishingVerifiedCustomDomainCertificatesMetadataObject {
                                             Thumbprint: [XXXXX]
                                             SubjectName: [XXXXX]
                                             Issuer:
                                             IssueDate: 11/9/2017 5:54:29
                                             ExpiryDate: 11/9/2019 5:54:29
                                           }

VerifiedCustomDomainKeyCredential        :
VerifiedCustomDomainPasswordCredential   :
SingleSignOnSettings                     :

Beispiel 2: Erstellen einer neuen Anwendung, die eine benutzerdefinierte Domäne verwendet und mehrere optionale Flags festlegt.

Parameter

-ApplicationServerTimeout

Legen Sie diesen Wert nur dann auf Long fest, wenn Ihre Anwendung sich nur langsam authentifiziert und eine Verbindung herstellt.

Parametereigenschaften

Typ:ApplicationServerTimeoutEnum
Standardwert:None
Zulässige Werte:Default, Long
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 dieser Anwendung zugewiesen werden soll. Sie können diesen Wert mit dem Befehl Get-AzureADApplicationProxyConnectorGroup ermitteln. 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 auf Standard zugewiesen.

Parametereigenschaften

Typ: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

-DisplayName

Der Anzeigename der neuen Anwendung

Parametereigenschaften

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

Parametersätze

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

-ExternalAuthenticationType

Wie der Anwendungsproxy Benutzer überprüft, bevor er ihnen Zugriff auf die Anwendung gewährt. AadPreAuthentication: Der Anwendungsproxy leitet Benutzer um, sich mit Azure AD anzumelden, wodurch ihre Berechtigungen für das Verzeichnis und die Anwendung authentifiziert werden. Es wird empfohlen, diese Option als Standard beizubehalten, damit Sie Azure AD-Sicherheitsfeatures wie bedingten Zugriff und mehrstufige Authentifizierung nutzen können. Passthru: Benutzer müssen sich nicht bei Azure Active Directory authentifizieren, um auf die Anwendung zugreifen zu können. Sie können weiterhin Authentifizierungsanforderungen auf dem Back-End einrichten.

Parametereigenschaften

Typ:ExternalAuthenticationTypeEnum
Standardwert:None
Zulässige Werte:AadPreAuthentication, Passthru
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, an die Ihre Benutzer gehen, um von außerhalb Ihres Netzwerks auf die App zuzugreifen.

Parametereigenschaften

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

Parametersätze

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

-InternalUrl

Die URL, die Sie verwenden, um von Ihrem privaten Netzwerk aus auf die Anwendung zuzugreifen. 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:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

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

-IsHttpOnlyCookieEnabled

{{ Fill IsHttpOnlyCookieEnabled Beschreibung }}

Parametereigenschaften

Typ: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

{{ Fill IsPersistentCookieEnabled Beschreibung }}

Parametereigenschaften

Typ: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

{{ Füllen Sie IsSecureCookieEnabled Beschreibung }}

Parametereigenschaften

Typ: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 diese Option auf true festgelegt ist, werden URLs in Kopfzeilen übersetzt. Behalten Sie diesen Wert true bei, es sei denn, Ihre Anwendung erforderte den ursprünglichen Hostheader in der Authentifizierungsanforderung.

Parametereigenschaften

Typ: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 auf true gesetzt, werden URLs im Text übersetzt. Behalten Sie diesen Wert als Nein bei, es sei denn, Sie haben hartcodierte HTML-Links zu anderen lokalen Anwendungen und verwenden keine benutzerdefinierten Domänen.

Parametereigenschaften

Typ: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.

Eingaben

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, Kultur=neutral, PublicKeyToken=null]]

Ausgaben

Object