Get-MsolServicePrincipal

  • Référence
Module:
MSOnline

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

Syntax

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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AppPrincipalId

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:500
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SearchString

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 de service.
  • AccountEnabled. Valeur indiquant si le compte est activé.