Udostępnij za pośrednictwem

Get-MsolServicePrincipal

  • Odwołanie
Moduł:
MSOnline

Pobiera jednostki usługi z usługi Azure Active Directory.

Składnia

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

Opis

Polecenie cmdlet Get-MsolServicePrincipal pobiera jednostkę usługi lub listę jednostek usługi z usługi Azure Active Directory.

Przykłady

Przykład 1. Wyświetlanie wszystkich jednostek usługi

PS C:\> Get-MsolServicePrincipal

To polecenie wyświetla wszystkie istniejące jednostki usługi w dzierżawie organizacji.

Przykład 2. Pobieranie jednostek usługi przy użyciu nazwy

PS C:\> Get-MsolServicePrincipal -ServicePrincipalName "MyApp"

To polecenie pobiera wszystkie istniejące jednostki usługi, które mają nazwę główną usługi rozpoczynającą się od myApp. Jest to dokładne dopasowanie części appClass nazwy głównej usługi do ukośnika.

Przykład 3. Pobieranie jednostki usługi

PS C:\> Get-MsolServicePrincipal -AppPrincipalId 5e964d2f-e384-4292-ae55-dd24c89cc53b

To polecenie pobiera jednostkę usługi z określonym identyfikatorem jednostki aplikacji.

Parametry

-All

Wskazuje, że to polecenie cmdlet zwraca wszystkie wyniki. Nie należy określać razem z parametrem MaxResults .

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

-AppPrincipalId

Określa unikatowy identyfikator aplikacji jednostki usługi do pobrania.

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

-MaxResults

Określa maksymalną liczbę wyników zwracanych przez to polecenie cmdlet. Wartość domyślna to 500.

Typ:Int32
Position:Named
Domyślna wartość:500
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ObjectId

Określa unikatowy identyfikator obiektu jednostki usługi do pobrania.

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

-SearchString

Określa ciąg, aby dopasować nazwy główne usługi.

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

-ServicePrincipalName

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

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

AppName reprezentuje nazwę aplikacji, a 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, w której ma być wykonywana operacja. Wartość domyślna to dzierżawa bieżącego użytkownika. Ten parametr ma zastosowanie tylko do 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.ServicePrincipal[]

To polecenie cmdlet zwraca jednostkę usługi lub listę jednostek usługi z usługi Azure Active Directory. Każda jednostka usługi zawiera następujące informacje:

  • Objectid. Unikatowy identyfikator jednostki usługi.
  • AppPrincipalId. Identyfikator aplikacji jednostki usługi.
  • Displayname. Przyjazna nazwa jednostki usługi.
  • Serviceprincipalname. Lista głównych nazw usług (SPN) skojarzonych z jednostką usługi.
  • AccountEnabled. Wartość wskazująca, czy konto jest włączone.