Partager via

New-AzureADServicePrincipal

  • Référence
Module:
AzureAD

Crée un principal de service.

Syntaxe

New-AzureADServicePrincipal
   [-AccountEnabled <String>]
   [-AlternativeNames <System.Collections.Generic.List`1[System.String]>]
   -AppId <String>
   [-AppRoleAssignmentRequired <Boolean>]
   [-DisplayName <String>]
   [-ErrorUrl <String>]
   [-Homepage <String>]
   [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.KeyCredential]>]
   [-LogoutUrl <String>]
   [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.PasswordCredential]>]
   [-PublisherName <String>]
   [-ReplyUrls <System.Collections.Generic.List`1[System.String]>]
   [-SamlMetadataUrl <String>]
   [-ServicePrincipalNames <System.Collections.Generic.List`1[System.String]>]
   [-ServicePrincipalType <String>]
   [-Tags <System.Collections.Generic.List`1[System.String]>]
   [<CommonParameters>]

Exemples

Exemple 1 : Créer un principal de service

PS C:\>New-AzureADServicePrincipal -AccountEnabled $true -AppId $MyApp.AppId -AppRoleAssignmentRequired $true -DisplayName $App -Tags {WindowsAzureActiveDirectoryIntegratedApp}

Cette commande crée un principal de service. La balise « -Tags {WindowsAzureActiveDirectoryIntegratedApp} » est utilisée pour que ce principal de service s’affiche dans la liste des applications intégrées dans le portail d’administration.

Paramètres

-AccountEnabled

true si le compte du principal du service est activé, sinon false.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AlternativeNames

Autres noms pour ce principal de service

Type:List<T>[String]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AppId

Identificateur unique de l'application associée (sa propriété appId).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AppRoleAssignmentRequired

Indique si une attribution de rôle d’application est requise.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplayName

Spécifie le nom complet.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ErrorUrl

Spécifie l’URL d’erreur.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Homepage

Spécifie la page d’accueil.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-KeyCredentials

Collection d'informations d'identification de clé associées au principal du service.

Type:List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LogoutUrl

Spécifie l’URL de déconnexion.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PasswordCredentials

Spécifie les informations d’identification du mot de passe.

Type:List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PublisherName

Spécifie le nom de l’éditeur.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ReplyUrls

URL auxquelles les jetons utilisateur sont envoyés pour la connexion avec l’application associée, ou URI de redirection auxquels les codes d’autorisation OAuth 2.0 et les jetons d’accès sont envoyés pour l’application associée.

Type:List<T>[String]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SamlMetadataUrl

URL des métadonnées SAML

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServicePrincipalNames

Spécifie un tableau de noms de principaux de service. En fonction de la collection identifierURIs et de la propriété appId de l’application, ces URI sont utilisés pour référencer le principal de service d’une application. Un client les utilise pour :

  • renseignez requiredResourceAccess via « Autorisations sur d’autres applications » dans le portail Azure Classic. - spécifiez un URI de ressource pour acquérir un jeton d’accès, qui est l’URI retourné dans la revendication.
Type:List<T>[String]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServicePrincipalType

Type THe du principal de service

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Tags

Balises liées à ce principal de service.

Notez que si vous envisagez que ce principal de service s’affiche dans la liste Toutes les applications du portail d’administration, vous devez définir cette valeur sur {WindowsAzureActiveDirectoryIntegratedApp}

Type:List<T>[String]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Notes

Consultez le guide de migration pour New-AzureADServicePrincipal vers Microsoft Graph PowerShell.