Freigeben über

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"

Mit diesem Befehl werden alle Anmeldeinformationen mit Ausnahme des Anmeldeinformationswerts abgerufen, die dem Dienstprinzipalnamen (SPN) MyApp/myApp.com zugeordnet sind. Ein SPN muss das Format appClass/hostname aufweisen, wobei appClass die Anwendungsklasse ("MyApp") und hostname den Hostnamen für die Anwendung darstellt (myApp.com).

Parameter

-AppPrincipalId

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

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ObjectId

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

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ReturnKeyValues

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

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServicePrincipalName

Gibt den Namen des Dienstprinzipals an, von 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.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TenantId

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

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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 Bezeichner, der für die interne Verwendung reserviert ist.
  • KeyId. Der eindeutige Bezeichner des Schlüssels.
  • Startdate. Das effektive Startdatum der Anmeldeinformationenverwendung.
  • Enddate. Das effektive Enddatum der Anmeldeinformationennutzung.
  • Verwendung. Gibt an, ob die Anmeldeinformationen zum "Signieren" oder "Überprüfen" eines Tokens verwendet werden.