Get-AzADServicePrincipal

Modul:

Az.Resources

Szolgáltatásnevek entitásainak listázása vagy entitás lekérése a szolgáltatásnevekből kulcs alapján

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

Description

Szolgáltatásnevek entitásainak listázása vagy entitás lekérése a szolgáltatásnevekből kulcs alapján

Példák

1. példa: Szolgáltatásnév lekérése megjelenítendő név alapján

Get-AzADServicePrincipal -DisplayName $name

Szolgáltatásnév lekérése megjelenítendő név alapján

2. példa: A szolgáltatásnév megjelenítendő nevének keresése a következővel kezdődik:

Get-AzADServicePrincipal -DisplayNameStartsWith $prefix

A szolgáltatásnév megjelenítendő nevének keresése a következővel kezdődik:

3. példa: Szolgáltatásnevek listázása

Get-AzADServicePrincipal -First 10 -Select Tags -AppendSelected

Az első 10 szolgáltatásnév listázása és a "Címkék" hozzáfűzési tulajdonság az alapértelmezett tulajdonságok után: "DisplayName", "Id", "DeletedDateTime", "ServicePrincipalNames", "AppId"

4. példa: Szolgáltatásnév lekérése alkalmazásazonosító szerint

Get-AzADServicePrincipal -ApplicationId $appId

Szolgáltatásnév lekérése alkalmazásazonosító szerint

5. példa: Szolgáltatásnév lekérése folyamatbemenet alapján

Get-AzADApplication -DisplayName $name | Get-AzADServicePrincipal

Szolgáltatásnév lekérése folyamatbemenet alapján

6. példa: Szolgáltatásnév lekérése szűrővel

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

Szolgáltatásnév lekérése szűrővel

7. példa: OdataCount hozzárendelése egy változóhoz

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

OdataCount hozzárendelése változóhoz

Paraméterek

-AppendSelected

Ha ez a kapcsoló be van kapcsolva, az alapértelmezett tulajdonságokkal kijelölt hozzáfűző tulajdonságok csak a "-Select" paraméterrel működnek.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ApplicationId

a serviceprincipal alkalmazásazonosítója

Típus:	Guid
Aliasok:	AppId
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ApplicationObject

A szolgáltatásnév objektum használható folyamatbemenetként.

Típus:	IMicrosoftGraphApplication
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-ConsistencyLevel

A kért konzisztenciaszintet jelzi. Dokumentáció URL-címe: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Count

Elemek számának belefoglalása

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-CountVariable

A gyűjteményben lévő elemek teljes számának számát adja meg. Alapértelmezés szerint ez a változó a globális hatókörben lesz beállítva.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Típus:	PSObject
Aliasok:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DisplayName

serviceprincipal display name

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DisplayNameBeginsWith

a serviceprincipal megjelenítési neve a következővel kezdődik:

Típus:	String
Aliasok:	DisplayNameStartsWith, SearchString
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Filter

Elemek szűrése tulajdonságértékek szerint, a szűrő lekérdezésével kapcsolatos további részletekért lásd: https://learn.microsoft.com/en-us/graph/filter-query-parameter

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-First

Csak az első "n" objektumokat kapja meg.

Típus:	UInt64
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ObjectId

kulcs: a servicePrincipal azonosítója

Típus:	String
Aliasok:	ServicePrincipalId, Id
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Orderby

Elemek rendezése tulajdonságértékek szerint

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Search

Elemek keresése keresési kifejezések alapján

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Select

A visszaadandó tulajdonságok kiválasztása

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ServicePrincipalName

serviceprincipal name

Típus:	String
Aliasok:	SPN
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Skip

Figyelmen kívül hagyja az első "n" objektumokat, majd lekéri a fennmaradó objektumokat.

Típus:	UInt64
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

IMicrosoftGraphApplication

Kimenetek

IMicrosoftGraphServicePrincipal