Get-AzADServicePrincipal

Reference

Modul:: Az.Resources

Zobrazí seznam entit z instančních objektů nebo získání entity z instančních objektů podle klíče.

Syntaxe

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

Description

Zobrazí seznam entit z instančních objektů nebo získání entity z instančních objektů podle klíče.

Příklady

Příklad 1: Získání instančního objektu podle zobrazovaného názvu

Get-AzADServicePrincipal -DisplayName $name

Získání instančního objektu podle zobrazovaného názvu

Příklad 2: Hledání zobrazovaného názvu instančního objektu začíná na

Get-AzADServicePrincipal -DisplayNameStartsWith $prefix

Hledání zobrazovaného názvu instančního objektu začíná na

Příklad 3: Výpis instančních objektů

Get-AzADServicePrincipal -First 10 -Select Tags -AppendSelected

Uveďte prvních 10 instančních objektů a za výchozí vlastnosti přidejte vlastnost Tags: DisplayName, Id, DeletedDateTime, ServicePrincipalNames, AppId.

Příklad 4: Získání instančního objektu podle ID aplikace

Get-AzADServicePrincipal -ApplicationId $appId

Získání instančního objektu podle ID aplikace

Příklad 5: Získání instančního objektu podle vstupu kanálu

Get-AzADApplication -DisplayName $name | Get-AzADServicePrincipal

Získání instančního objektu podle vstupu kanálu

Příklad 6: Získání instančního objektu s filtrem

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

Získání instančního objektu s filtrem

Příklad 7: Přiřazení OdataCount k proměnné

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

Přiřazení OdataCount k proměnné

Parametry

-AppendSelected

Připojte vlastnosti vybrané s výchozími vlastnostmi, pokud je tento přepínač zapnutý, funguje pouze s parametrem -Select.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ApplicationId

ID aplikace serviceprincipal

Typ:	Guid
Aliasy:	AppId
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ApplicationObject

Instanční objekt lze použít jako vstup kanálu.

Typ:	IMicrosoftGraphApplication
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ConsistencyLevel

Označuje požadovanou úroveň konzistence. Adresa URL dokumentace: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Count

Zahrnout počet položek

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CountVariable

Určuje počet celkového počtu položek v kolekci. Ve výchozím nastavení se tato proměnná nastaví v globálním oboru.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	PSObject
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DisplayName

zobrazovaný název serviceprincipal

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DisplayNameBeginsWith

Zobrazovaný název serviceprincipal začíná na

Typ:	String
Aliasy:	DisplayNameStartsWith, SearchString
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Filter

Filtrování položek podle hodnot vlastností, další podrobnosti o dotazu filtru najdete v tématu: https://learn.microsoft.com/en-us/graph/filter-query-parameter

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-First

Získá pouze první n objekty.

Typ:	UInt64
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ObjectId

key: ID servicePrincipal

Typ:	String
Aliasy:	ServicePrincipalId, Id
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Orderby

Pořadí položek podle hodnot vlastností

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Search

Hledání položek podle vyhledávacích frází

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Select

Výběr vlastností, které se mají vrátit

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ServicePrincipalName

serviceprincipal name

Typ:	String
Aliasy:	SPN
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Skip

Ignoruje první n objekty a pak získá zbývající objekty.

Typ:	UInt64
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

IMicrosoftGraphApplication

Výstupy

IMicrosoftGraphServicePrincipal

Sdílet prostřednictvím