Partager via

New-AzureADApplicationProxyApplication

Module:
AzureAD Module

L’applet de commande New-AzureADApplicationProxyApplication crée une application configurée pour le proxy d’application dans Azure Active Directory.

Syntaxe

Default (Par défaut) 

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

Description

L’applet de commande New-AzureADApplicationProxyApplication crée une application configurée pour le proxy d’application dans Azure Active Directory. Pour vous assurer que cette application est utilisable, assurez-vous également d’affecter des utilisateurs et de configurer l’authentification unique si nécessaire. Notez que sans spécifier de ConnectorGroupId, cette application utilisera par défaut le groupe de connecteurs par défaut dans votre locataire.

Exemples

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

Exemple 1 : Création d’une application avec uniquement les paramètres de base requis et le domaine par défaut pour les applications.

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

Exemple 2 : Création d’une application qui utilise un domaine personnalisé et définit plusieurs indicateurs facultatifs.

Paramètres

-ApplicationServerTimeout

Définissez cette valeur sur Long uniquement si votre application tarde à s’authentifier et à se connecter.

Propriétés du paramètre

Type:ApplicationServerTimeoutEnum
Valeur par défaut:None
Valeurs acceptées:Default, Long
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ConnectorGroupId

Indiquez l’ID du groupe de connecteurs que vous souhaitez attribuer à cette application. Vous pouvez trouver cette valeur à l’aide de la commande Get-AzureADApplicationProxyConnectorGroup. Les connecteurs gèrent l'accès à distance à votre application et les groupes de connecteurs vous aident à organiser des connecteurs et des applications par région, réseau ou objectif. Si aucun groupe de connecteurs n’a encore été créé, votre application est affectée à la valeur Par défaut.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DisplayName

Le nom d’affichage de la nouvelle application

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ExternalAuthenticationType

Comment le proxy d’application vérifie les utilisateurs avant de leur donner accès à votre application. AadPreAuthentication : le proxy d’application redirige les utilisateurs pour qu’ils se connectent avec Azure AD, ce qui authentifie leurs autorisations pour l’annuaire et l’application. Nous vous recommandons de conserver cette option par défaut afin de pouvoir tirer parti des fonctionnalités de sécurité d’Azure AD telles que l’accès conditionnel et l’authentification multifacteur. Passthru : les utilisateurs n’ont pas besoin de s’authentifier auprès d’Azure Active Directory pour accéder à l’application. Vous pouvez toujours configurer les exigences d’authentification sur le serveur principal.

Propriétés du paramètre

Type:ExternalAuthenticationTypeEnum
Valeur par défaut:None
Valeurs acceptées:AadPreAuthentication, Passthru
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ExternalUrl

L’adresse à laquelle vos utilisateurs se rendront pour accéder à l’application depuis l’extérieur de votre réseau.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-InternalUrl

URL que vous utilisez pour accéder à l’application à partir de votre réseau privé. Vous pouvez spécifier un chemin spécifique sur le serveur principal à publier, alors que le reste du serveur n’est pas publié. De cette façon, vous pouvez publier des sites différents sur le même serveur en tant qu’applications distinctes et donner à chacun d’eux son propre nom et ses propres règles d’accès. Si vous publiez un chemin d’accès, vérifiez qu’il inclut l’ensemble des images, des scripts et des feuilles de style nécessaires pour votre application.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-IsHttpOnlyCookieEnabled

{{ Remplir IsHttpOnlyCookieEnabled Description }}

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-IsPersistentCookieEnabled

{{ Remplir IsPersistentCookieEnabled Description }}

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-IsSecureCookieEnabled

{{ Remplir IsSecureCookieEnabled Description }}

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-IsTranslateHostHeaderEnabled

S’il est défini à true, traduit les urls dans les en-têtes. Conservez cette valeur true, sauf si votre application a besoin de l’en-tête d’hôte d’origine dans la demande d’authentification.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-IsTranslateLinksInBodyEnabled

S’il est défini à true, traduit les urls dans le corps. Conservez la valeur Non à moins que vous n’ayez des liens HTML codés en dur vers d’autres applications locales et que vous n’utilisiez pas de domaines personnalisés.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

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

Sorties

Object