Get-AzADServicePrincipal

Referenz

Modul:: Az.Resources

Listet Entitäten aus Dienstprinzipalen auf oder ruft entitäten von Dienstprinzipalen nach Schlüssel ab.

Syntax

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

Beschreibung

Listet Entitäten aus Dienstprinzipalen auf oder ruft entitäten von Dienstprinzipalen nach Schlüssel ab.

Beispiele

Beispiel 1: Abrufen des Dienstprinzipals nach Anzeigename

Get-AzADServicePrincipal -DisplayName $name

Dienstprinzipal nach Anzeigename abrufen

Beispiel 2: Der Anzeigename des Dienstprinzipals beginnt mit

Get-AzADServicePrincipal -DisplayNameStartsWith $prefix

Suche nach Anzeigenamen des Dienstprinzipals beginnt mit

Beispiel 3: Dienstprinzipale auflisten

Get-AzADServicePrincipal -First 10 -Select Tags -AppendSelected

Auflisten der ersten 10 Dienstprinzipale und Anfügen der Eigenschaft "Tags" nach Standardeigenschaften: "DisplayName", "Id", "DeletedDateTime", "ServicePrincipalNames", "AppId"

Beispiel 4: Abrufen des Dienstprinzipals nach Anwendungs-ID

Get-AzADServicePrincipal -ApplicationId $appId

Dienstprinzipal nach Anwendungs-ID abrufen

Beispiel 5: Abrufen des Dienstprinzipals nach Pipelineeingabe

Get-AzADApplication -DisplayName $name | Get-AzADServicePrincipal

Abrufen des Dienstprinzipals nach Pipelineeingabe

Beispiel 6: Abrufen des Dienstprinzipals mit Filter

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

Dienstprinzipal mit Filter abrufen

Beispiel 7: Zuweisen von OdataCount zu einer Variablen

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

Zuweisen von OdataCount zu einer Variablen

Parameter

-AppendSelected

Eigenschaften anfügen, die mit Standardeigenschaften ausgewählt sind, wenn dieser Schalter aktiviert ist, funktioniert nur mit dem Parameter "-Select".

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ApplicationId

Anwendungs-ID von serviceprincipal

Typ:	Guid
Aliase:	AppId
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ApplicationObject

Das Dienstprinzipalobjekt kann als Pipelineeingabe verwendet werden.

Typ:	IMicrosoftGraphApplication
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ConsistencyLevel

Gibt die angeforderte Konsistenzstufe an. Dokumentations-URL: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Count

Anzahl der Elemente einschließen

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-CountVariable

Gibt eine Anzahl der Gesamtanzahl der Elemente in einer Auflistung an. Diese Variable wird standardmäßig im globalen Bereich festgelegt.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:	PSObject
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DisplayName

serviceprincipal display name

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DisplayNameBeginsWith

Der Name des dienstprincipal-Anzeigenamens beginnt mit

Typ:	String
Aliase:	DisplayNameStartsWith, SearchString
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Filter

Filtern von Elementen nach Eigenschaftswerten, weitere Details zur Filterabfrage finden Sie unter: https://learn.microsoft.com/en-us/graph/filter-query-parameter

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-First

Ruft nur die ersten n -Objekte ab.

Typ:	UInt64
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ObjectId

key: id of servicePrincipal

Typ:	String
Aliase:	ServicePrincipalId, Id
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Orderby

Elemente nach Eigenschaftswerten sortieren

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Search

Durchsuchen von Elementen nach Suchbegriffen

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Select

Eigenschaften auswählen, die zurückgegeben werden sollen

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ServicePrincipalName

serviceprincipal name

Typ:	String
Aliase:	SPN
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Skip

Ignoriert die ersten n-Objekte und ruft dann die verbleibenden Objekte ab.

Typ:	UInt64
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

IMicrosoftGraphApplication

Ausgaben

IMicrosoftGraphServicePrincipal

Freigeben über