Share via

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 .

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

-AppPrincipalId

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

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

-MaxResults

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

Type:Int32
Position:Named
Default value:500
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

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

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

-SearchString

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.