Udostępnij za pośrednictwem

Get-MsolServicePrincipalCredential

  • Odwołanie
Moduł:
MSOnline

Pobiera poświadczenia skojarzone z jednostką usługi.

Składnia

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

Opis

Polecenie cmdlet Get-MsolServicePrincipalCredential pobiera poświadczenia skojarzone z jednostką usługi.

Przykłady

Przykład 1. Pobieranie właściwości poświadczeń

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

To polecenie pobiera wszystkie właściwości poświadczeń, z wyjątkiem wartości poświadczeń, które są skojarzone z główną nazwą usługi (SPN) MyApp/myApp.com. Nazwa SPN musi być zgodna z formatem appClass/hostname, gdzie appClass reprezentuje klasę aplikacji ("MyApp"), a nazwa hosta reprezentuje nazwę hosta aplikacji (myApp.com).

Parametry

-AppPrincipalId

Określa identyfikator aplikacji jednostki usługi, dla której mają być uzyskiwane poświadczenia.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ObjectId

Określa unikatowy identyfikator obiektu jednostki usługi, dla której mają być uzyskiwane poświadczenia.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ReturnKeyValues

Wskazuje, czy to polecenie cmdlet zwraca wartości klucza.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ServicePrincipalName

Określa nazwę jednostki usługi, z której mają być uzyskiwane poświadczenia. Nazwa SPN musi używać jednego z następujących formatów:

  • appName
  • appName/hostname
  • prawidłowy adres URL

AppName reprezentuje nazwę aplikacji. Nazwa hosta reprezentuje urząd URI aplikacji.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-TenantId

Określa unikatowy identyfikator dzierżawy, na którym ma być wykonywana operacja. Wartość domyślna to dzierżawa bieżącego użytkownika. Ten parametr dotyczy tylko użytkowników partnerów.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

Microsoft.Online.Administration.ServicePrincipalCredential[]

To polecenie cmdlet zwraca poświadczenia skojarzone z jednostką usługi. Każdy zwrócony obiekt zawiera następujące informacje:

  • Typu. Typ poświadczenia jednostki usługi (asymetryczna/symetryczna/hasło).
  • Wartość. Wartość poświadczenia.
    • Jeśli typ poświadczeń to certyfikat, reprezentuje certyfikat zakodowany w formacie base 64.
    • Jeśli typ poświadczeń jest symetryczny, reprezentuje klucz AES.
  • KeyGroupId. Identyfikator zarezerwowany do użytku wewnętrznego.
  • KeyId. Unikatowy identyfikator klucza.
  • Startdate. Data rozpoczęcia użycia poświadczeń.
  • Enddate. Obowiązująca data zakończenia użycia poświadczeń.
  • Użycia. Określa, czy poświadczenie jest używane do "podpisywania" lub "weryfikowania" tokenu.