Delen via

Get-AzADServicePrincipal

Module:
Az.Resources Module

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

Syntax

EmptyParameterSet (Standaard) 

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

ObjectIdParameterSet 

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

SearchStringParameterSet 

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

DisplayNameParameterSet 

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

ApplicationIdParameterSet 

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

ApplicationObjectParameterSet 

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

SPNParameterSet 

Get-AzADServicePrincipal
    -ServicePrincipalName <String>
    [-Select <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'.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ApplicationId

toepassings-id van serviceprincipal

Parametereigenschappen

Type:Guid
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AppId

Parametersets

ApplicationIdParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ApplicationObject

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

Parametereigenschappen

Type:IMicrosoftGraphApplication
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ApplicationObjectParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ConsistencyLevel

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

EmptyParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Count

Aantal items opnemen

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

EmptyParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-CountVariable

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

EmptyParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:PSObject
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DisplayName

weergavenaam van serviceprincipal

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

DisplayNameParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DisplayNameBeginsWith

weergavenaam van serviceprincipal begint met

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:DisplayNameStartsWith, SearchString

Parametersets

SearchStringParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Filter

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

EmptyParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-First

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

Parametereigenschappen

Type:UInt64
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ObjectId

sleutel: id van servicePrincipal

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ServicePrincipalId, Identiteitsbewijs

Parametersets

ObjectIdParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Orderby

Items orden op eigenschapswaarden

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

EmptyParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Search

Items zoeken op zoektermen

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

EmptyParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Select

Eigenschappen selecteren die moeten worden geretourneerd

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ServicePrincipalName

serviceprincipal name

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:SPN

Parametersets

SPNParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Skip

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

Parametereigenschappen

Type:UInt64
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

IMicrosoftGraphApplication

Uitvoerwaarden

IMicrosoftGraphServicePrincipal