Delen via


Get-AzADServicePrincipal

Een lijst met entiteiten van service-principals of entiteit ophalen uit service-principals per sleutel

Syntaxis

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

Een lijst met entiteiten van service-principals of entiteit ophalen uit service-principals per sleutel

Voorbeelden

Voorbeeld 1: Service-principal ophalen op weergavenaam

Get-AzADServicePrincipal -DisplayName $name

Service-principal ophalen op weergavenaam

Voorbeeld 2: De weergavenaam van de service-principal begint met

Get-AzADServicePrincipal -DisplayNameStartsWith $prefix

De weergavenaam van de service-principal begint met

Voorbeeld 3: Service-principals vermelden

Get-AzADServicePrincipal -First 10 -Select Tags -AppendSelected

Lijst met eerste 10 service-principals en toevoegeigenschap Tags na standaardeigenschappen: 'DisplayName', 'Id', 'DeletedDateTime', 'ServicePrincipalNames', 'AppId'

Voorbeeld 4: Service-principal ophalen op toepassings-id

Get-AzADServicePrincipal -ApplicationId $appId

Service-principal ophalen op toepassings-id

Voorbeeld 5: Service-principal ophalen op basis van pijplijninvoer

Get-AzADApplication -DisplayName $name | Get-AzADServicePrincipal

Service-principal ophalen op basis van pijplijninvoer

Voorbeeld 6: Service-principal ophalen met filter

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

Service-principal ophalen met filter

Voorbeeld 7: OdataCount toewijzen aan een variabele

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

OdataCount toewijzen aan een variabele

Parameters

-AppendSelected

Eigenschappen toevoegen die zijn geselecteerd met standaardeigenschappen wanneer deze schakeloptie is ingeschakeld, werkt alleen met de parameter '-Select'.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ApplicationId

toepassings-id van serviceprincipal

Type:Guid
Aliassen:AppId
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ApplicationObject

Het service-principal-object kan worden gebruikt als pijplijninvoer.

Type:IMicrosoftGraphApplication
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ConsistencyLevel

Geeft het aangevraagde consistentieniveau aan. Documentatie-URL: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Count

Aantal items opnemen

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CountVariable

Hiermee geeft u een telling van het totale aantal items in een verzameling. Deze variabele wordt standaard ingesteld in het globale bereik.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:PSObject
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayName

weergavenaam van serviceprincipal

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayNameBeginsWith

weergavenaam van serviceprincipal begint met

Type:String
Aliassen:DisplayNameStartsWith, SearchString
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Filter

Filter items op eigenschapswaarden voor meer informatie over filterquery: https://learn.microsoft.com/en-us/graph/filter-query-parameter

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-First

Hiermee worden alleen de eerste 'n'-objecten opgehaald.

Type:UInt64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ObjectId

sleutel: id van servicePrincipal

Type:String
Aliassen:ServicePrincipalId, Id
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Orderby

Items orden op eigenschapswaarden

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Items zoeken op zoektermen

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Select

Eigenschappen selecteren die moeten worden geretourneerd

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServicePrincipalName

serviceprincipal name

Type:String
Aliassen:SPN
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Skip

Negeert de eerste 'n'-objecten en haalt vervolgens de resterende objecten op.

Type:UInt64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

IMicrosoftGraphApplication

Uitvoerwaarden

IMicrosoftGraphServicePrincipal