Get-MsolServicePrincipalCredential

  • Referenz
Modul:
MSOnline

Ruft Anmeldeinformationen ab, die einem Dienstprinzipal zugeordnet sind.

Syntax

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

Beschreibung

Das Cmdlet Get-MsolServicePrincipalCredential ruft Anmeldeinformationen ab, die einem Dienstprinzipal zugeordnet sind.

Beispiele

Beispiel 1: Abrufen von Anmeldeinformationseigenschaften

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

Dieser Befehl ruft alle Anmeldeinformationeneigenschaften ab, mit Ausnahme des Anmeldeinformationswerts, die dem Dienstprinzipalnamen (SPN) MyApp/myApp.com zugeordnet sind. Ein SPN muss dem Format "appClass/hostname" folgen, wobei "appClass" die Anwendungsklasse ("MyApp") und der Hostname den Hostnamen für die Anwendung (myApp.com) darstellt.

Parameter

-AppPrincipalId

Gibt die Anwendungs-ID des Dienstprinzipals an, für den Anmeldeinformationen abgerufen werden sollen.

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

-ObjectId

Gibt die eindeutige Objekt-ID des Dienstprinzipals an, für den Anmeldeinformationen abgerufen werden sollen.

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

-ReturnKeyValues

Gibt an, ob dieses Cmdlet Schlüsselwerte zurückgibt.

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

-ServicePrincipalName

Gibt den Namen des Dienstprinzipals an, aus dem Anmeldeinformationen abgerufen werden sollen. Ein SPN muss eines der folgenden Formate verwenden:

  • appName
  • appName/hostname
  • eine gültige URL

AppName stellt den Namen der Anwendung dar. Hostname stellt die URI-Autorität für die Anwendung dar.

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

-TenantId

Gibt die eindeutige ID des Mandanten an, auf dem der Vorgang ausgeführt werden soll. Der Standardwert ist der Mandant des aktuellen Benutzers. Dieser Parameter gilt nur für Partnerbenutzer.

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

Ausgaben

Microsoft.Online.Administration.ServicePrincipalCredential[]

Dieses Cmdlet gibt die Anmeldeinformationen zurück, die einem Dienstprinzipal zugeordnet sind. Jedes zurückgegebene Objekt enthält die folgenden Informationen:

  • Type (Typ). Der Typ der Dienstprinzipalanmeldeinformationen (asymmetrisch/symmetrisch/Kennwort).
  • Wert. Der Wert der Anmeldeinformationen.
    • Entspricht der Typ der Anmeldeinformationen einem Zertifikat, stellt der Wert das Base64-codierte Zertifikat dar.
    • Wenn der Anmeldeinformationstyp symmetrisch ist, stellt er einen AES-Schlüssel dar.
  • KeyGroupId. Der für die interne Verwendung reservierte Bezeichner.
  • KeyId. Der eindeutige Bezeichner des Schlüssels.
  • Startdate. Das effektive Startdatum der Anmeldeinformationennutzung.
  • Enddate. Das effektive Enddatum der Anmeldeinformationenverwendung.
  • Verwendung. Gibt an, ob die Anmeldeinformationen zum "Signieren" oder "Überprüfen" eines Tokens verwendet werden.