Get-AzADServicePrincipal

Odwołanie

Moduł:: Az.Resources

Wyświetla listę jednostek z jednostek usługi lub pobieranie jednostki usługi z jednostek usługi według klucza

Składnia

Get-AzADServicePrincipal
   [-Select <String[]>]
   [-Count]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   -ObjectId <String>
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -DisplayNameBeginsWith <String>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -DisplayName <String>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -ApplicationId <Guid>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -ApplicationObject <IMicrosoftGraphApplication>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -ServicePrincipalName <String>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Opis

Wyświetla listę jednostek z jednostek usługi lub pobieranie jednostki usługi z jednostek usługi według klucza

Przykłady

Przykład 1. Pobieranie jednostki usługi według nazwy wyświetlanej

Get-AzADServicePrincipal -DisplayName $name

Pobieranie jednostki usługi według nazwy wyświetlanej

Przykład 2. Wyszukiwanie nazwy wyświetlanej jednostki usługi rozpoczyna się od

Get-AzADServicePrincipal -DisplayNameStartsWith $prefix

Wyszukiwanie nazwy wyświetlanej jednostki usługi rozpoczyna się od

Przykład 3. Wyświetlanie listy jednostek usługi

Get-AzADServicePrincipal -First 10 -Select Tags -AppendSelected

Wyświetl pierwsze 10 jednostek usługi i dołącz właściwość "Tags" po właściwościach domyślnych: "DisplayName", "Id", "DeletedDateTime", "ServicePrincipalNames", "AppId"

Przykład 4. Pobieranie jednostki usługi według identyfikatora aplikacji

Get-AzADServicePrincipal -ApplicationId $appId

Pobieranie jednostki usługi według identyfikatora aplikacji

Przykład 5. Pobieranie jednostki usługi według danych wejściowych potoku

Get-AzADApplication -DisplayName $name | Get-AzADServicePrincipal

Pobieranie jednostki usługi według danych wejściowych potoku

Przykład 6. Pobieranie jednostki usługi z filtrem

Get-AzADServicePrincipal -Filter "startsWith(DisplayName,'some-name')"

Pobieranie jednostki usługi z filtrem

Przykład 7. Przypisywanie zmiennej OdataCount do zmiennej

Get-AzADServicePrincipal -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result

Przypisywanie wartości OdataCount do zmiennej

Parametry

-AppendSelected

Dołącz właściwości wybrane z właściwościami domyślnymi, gdy ten przełącznik jest włączony, działa tylko z parametrem "-Select".

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

-ApplicationId

identyfikator aplikacji elementu serviceprincipal

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

-ApplicationObject

Obiekt jednostki usługi może służyć jako dane wejściowe potoku.

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

-ConsistencyLevel

Wskazuje żądany poziom spójności. Adres URL dokumentacji: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

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

-Count

Uwzględnij liczbę elementów

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

-CountVariable

Określa liczbę całkowitej liczby elementów w kolekcji. Domyślnie ta zmienna zostanie ustawiona w zakresie globalnym.

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

-DefaultProfile

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

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

-DisplayName

nazwa wyświetlana elementu serviceprincipal

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

-DisplayNameBeginsWith

Nazwa wyświetlana elementu serviceprincipal rozpoczyna się od

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

-Filter

Filtruj elementy według wartości właściwości, aby uzyskać więcej informacji na temat zapytania filtru, zobacz: https://learn.microsoft.com/en-us/graph/filter-query-parameter

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

-First

Pobiera tylko pierwsze obiekty "n".

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

-ObjectId

key: identyfikator servicePrincipal

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

-Orderby

Porządkowaj elementy według wartości właściwości

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

-Search

Wyszukiwanie elementów według fraz wyszukiwania

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

-Select

Wybierz właściwości, które mają zostać zwrócone

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

-ServicePrincipalName

serviceprincipal name (nazwa obiektu serviceprincipal)

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

-Skip

Ignoruje pierwsze obiekty "n", 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

IMicrosoftGraphApplication

Dane wyjściowe

IMicrosoftGraphServicePrincipal

Udostępnij za pośrednictwem