Partager via

Get-MsolServicePrincipal

  • Référence
Module:
MSOnline

Obtient les principaux de service à partir d’Azure Active Directory.

Syntaxe

Get-MsolServicePrincipal
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

L’applet de commande Get-MsolServicePrincipal obtient un principal de service ou une liste de principaux de service à partir d’Azure Active Directory.

Exemples

Exemple 1 : Afficher tous les principaux de service

PS C:\> Get-MsolServicePrincipal

Cette commande affiche tous les principaux de service existants dans le locataire de l’organisation.

Exemple 2 : Obtenir des principaux de service à l’aide d’un nom

PS C:\> Get-MsolServicePrincipal -ServicePrincipalName "MyApp"

Cette commande obtient tous les principaux de service existants qui ont un nom de principal de service qui commence par MyApp. Il s’agit d’une correspondance exacte de la partie appClass du nom du principal de service jusqu’à la barre oblique.

Exemple 3 : Obtenir un principal de service

PS C:\> Get-MsolServicePrincipal -AppPrincipalId 5e964d2f-e384-4292-ae55-dd24c89cc53b

Cette commande obtient un principal de service qui a un ID de principal d’application spécifique.

Paramètres

-All

Indique que cette applet de commande retourne tous les résultats. Ne spécifiez pas avec le paramètre MaxResults .

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

-AppPrincipalId

Spécifie l’ID d’application unique du principal de service à obtenir.

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

-MaxResults

Spécifie le nombre maximal de résultats retournés par cette applet de commande. La valeur par défaut est 500.

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

-ObjectId

Spécifie l’ID d’objet unique du principal de service à obtenir.

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

-SearchString

Spécifie une chaîne pour faire correspondre les noms de principal de service.

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

-ServicePrincipalName

Spécifie le nom du principal de service ou des principaux de service à obtenir. Un SPN doit utiliser l’un des formats suivants :

  • appName
  • appName/hostname
  • UNE URL valide

AppName représente le nom de l’application et le nom d’hôte représente l’autorité URI de l’application.

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

-TenantId

Spécifie l’ID unique du locataire sur lequel effectuer l’opération. La valeur par défaut est le locataire de l’utilisateur actuel. Ce paramètre s’applique uniquement aux utilisateurs partenaires.

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

Sorties

Microsoft.Online.Administration.ServicePrincipal[]

Cette applet de commande retourne un principal de service ou une liste de principaux de service à partir d’Azure Active Directory. Chaque principal de service contient les informations suivantes :

  • Objectid. Identificateur unique du principal de service.
  • AppPrincipalId. Identificateur d’application du principal de service.
  • DisplayName. Nom convivial du principal de service.
  • Serviceprincipalname. Liste des noms de principaux de service (SPN) associés au principal du service.
  • AccountEnabled. Valeur indiquant si le compte est activé.