Partager via


Get-MsolServicePrincipalCredential

Obtient les informations d’identification associées à un principal de service.

Syntaxe

Get-MsolServicePrincipalCredential
   -ObjectId <Guid>
   -ReturnKeyValues <Boolean>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipalCredential
   -ReturnKeyValues <Boolean>
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipalCredential
   -ReturnKeyValues <Boolean>
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

L’applet de commande Get-MsolServicePrincipalCredential obtient les informations d’identification associées à un principal de service.

Exemples

Exemple 1 : Obtenir des propriétés d’informations d’identification

PS C:\> Get-MsolServicePrincipalCredential -ServicePrincipalName "MyApp/myApp.com"

Cette commande obtient toutes les propriétés d’informations d’identification, à l’exception de la valeur des informations d’identification, qui sont associées au nom du principal de service (SPN) MyApp/myApp.com. Un SPN doit suivre le format appClass/hostname, où appClass représente la classe d’application (« MyApp ») et hostname représente le nom d’hôte de l’application (myApp.com).

Paramètres

-AppPrincipalId

Spécifie l’ID d’application du principal de service pour lequel obtenir des informations d’identification.

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

-ObjectId

Spécifie l’ID d’objet unique du principal de service pour lequel obtenir des informations d’identification.

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

-ReturnKeyValues

Indique si cette applet de commande retourne des valeurs de clé.

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

-ServicePrincipalName

Spécifie le nom du principal de service à partir duquel obtenir les informations d’identification. Un SPN doit utiliser l’un des formats suivants :

  • appName
  • appName/hostname
  • UNE URL valide

AppName représente le nom de l’application. Le nom d’hôte représente l’autorité DE l’URI pour 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.ServicePrincipalCredential[]

Cette applet de commande retourne les informations d’identification associées à un principal de service. Chaque objet retourné contient les informations suivantes :

  • Type. Type d’informations d’identification du principal de service (asymétrique/symétrique/mot de passe).
  • Valeur. Valeur des informations d’identification.
    • Si le type d'informations d'identification est certificat, il s'agit du certificat encodé en base 64.
    • Si le type d’informations d’identification est symétrique, il représente une clé AES.
  • KeyGroupId. Identificateur réservé à une utilisation interne.
  • KeyId. Identificateur unique de la clé.
  • Startdate. Date de début effective de l’utilisation des informations d’identification.
  • EndDate. Date de fin effective de l’utilisation des informations d’identification.
  • Utilisation. Spécifie si les informations d’identification sont utilisées pour « signer » ou « vérifier » un jeton.