Udostępnij za pośrednictwem

Get-AzureRmADServicePrincipal

  • Odwołanie
Moduł:
AzureRM.Resources

Filtruje jednostki usługi active directory.

Ostrzeżenie

Moduł AzureRM PowerShell został oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

Get-AzureRmADServicePrincipal
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -DisplayNameBeginsWith <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -DisplayName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ObjectId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ApplicationId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ApplicationObject <PSADApplication>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ServicePrincipalName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]

Opis

Filtruje jednostki usługi active directory.

Przykłady

Przykład 1 — wyświetlanie listy jednostek usługi AD

PS C:\> Get-AzureRmADServicePrincipal

Wyświetla listę wszystkich jednostek usługi AD w dzierżawie.

Przykład 2 — Wyświetlanie listy jednostek usługi AD przy użyciu stronicowania

PS C:\> Get-AzureRmADServicePrincipal -First 100

Wyświetla listę pierwszych 100 jednostek usługi AD w dzierżawie.

Przykład 3 — Wyświetlanie listy jednostek usługi według głównej nazwy usługi

PS C:\> Get-AzureRmADServicePrincipal -ServicePrincipalName 36f81fc3-b00f-48cd-8218-3879f51ff39f

Wyświetla listę jednostek usługi z nazwą SPN "36f81fc3-b00f-48cd-8218-3879f51ff39f".

Przykład 4 — Wyświetlanie listy jednostek usługi według ciągu wyszukiwania

PS C:\> Get-AzureRmADServicePrincipal -SearchString "Web"

Wyświetla listę wszystkich jednostek usługi AD, których nazwa wyświetlana zaczyna się od "Sieć Web".

Przykład 5 — wyświetlanie listy jednostek usługi przez potoki

PS C:\> Get-AzureRmADApplication -ObjectId 39e64ec6-569b-4030-8e1c-c3c519a05d69 | Get-AzureRmADServicePrincipal

Pobiera aplikację usługi AD o identyfikatorze obiektu "39e64ec6-569b-4030-8e1c-c3c519a05d69" i potokuje go do polecenia cmdlet Get-AzureRmADServicePrincipal, aby wyświetlić listę wszystkich jednostek usługi dla tej aplikacji.

Parametry

-ApplicationId

Identyfikator aplikacji jednostki usługi.

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

-ApplicationObject

Obiekt aplikacji, którego jednostka usługi jest pobierana.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DisplayName

Nazwa wyświetlana jednostki usługi.

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

-DisplayNameBeginsWith

Ciąg wyszukiwania jednostki usługi.

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

-First

Maksymalna liczba zwracanych obiektów.

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

-IncludeTotalCount

Raportuje liczbę obiektów w zestawie danych. Obecnie ten parametr nic nie robi.

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

-ObjectId

Identyfikator obiektu jednostki usługi.

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

-ServicePrincipalName

Nazwa SPN usługi.

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

-Skip

Ignoruje pierwsze N obiektów, a następnie pobiera pozostałe obiekty.

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

Dane wejściowe

String

Guid

PSADApplication

Parametry: ApplicationObject (ByValue)

Dane wyjściowe

PSADServicePrincipal