Dela via


Get-AzADServicePrincipal

Visar entiteter från tjänstens huvudnamn eller hämta entiteter från tjänstens huvudnamn efter nyckel

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

Visar entiteter från tjänstens huvudnamn eller hämta entiteter från tjänstens huvudnamn efter nyckel

Exempel

Exempel 1: Hämta tjänstens huvudnamn efter visningsnamn

Get-AzADServicePrincipal -DisplayName $name

Hämta tjänstens huvudnamn efter visningsnamn

Exempel 2: Sök efter visningsnamnet för tjänstens huvudnamn börjar med

Get-AzADServicePrincipal -DisplayNameStartsWith $prefix

Sök efter visningsnamnet för tjänstens huvudnamn börjar med

Exempel 3: Lista tjänstens huvudnamn

Get-AzADServicePrincipal -First 10 -Select Tags -AppendSelected

Lista de första 10 huvudnamnen för tjänsten och lägg till egenskapen "Taggar" efter standardegenskaperna: "DisplayName", "Id", "DeletedDateTime", "ServicePrincipalNames", "AppId"

Exempel 4: Hämta tjänstens huvudnamn efter program-ID

Get-AzADServicePrincipal -ApplicationId $appId

Hämta tjänstens huvudnamn efter program-ID

Exempel 5: Hämta tjänstens huvudnamn efter pipelineindata

Get-AzADApplication -DisplayName $name | Get-AzADServicePrincipal

Hämta tjänstens huvudnamn efter pipelineindata

Exempel 6: Hämta tjänstens huvudnamn med filter

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

Hämta tjänstens huvudnamn med filter

Exempel 7: Tilldela OdataCount till en variabel

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

Tilldela OdataCount till en variabel

Parametrar

-AppendSelected

Tilläggsegenskaper som valts med standardegenskaper när den här växeln är på fungerar bara med parametern "-Select".

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ApplicationId

program-ID för serviceprincipal

Typ:Guid
Alias:AppId
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ApplicationObject

Objektet för tjänstens huvudnamn kan användas som pipelineindata.

Typ:IMicrosoftGraphApplication
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ConsistencyLevel

Anger den begärda konsekvensnivån. 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
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Count

Inkludera antal objekt

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CountVariable

Anger antalet objekt i en samling. Som standard anges den här variabeln i det globala omfånget.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:PSObject
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayName

serviceprincipal visningsnamn

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayNameBeginsWith

serviceprincipalt visningsnamn börjar med

Typ:String
Alias:DisplayNameStartsWith, SearchString
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Filter

Filtrera objekt efter egenskapsvärden för mer information om filterfrågan i: https://learn.microsoft.com/en-us/graph/filter-query-parameter

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-First

Hämtar bara de första n-objekten.

Typ:UInt64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ObjectId

nyckel: ID för servicePrincipal

Typ:String
Alias:ServicePrincipalId, Id
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Orderby

Sortera objekt efter egenskapsvärden

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Sök efter sökfraser

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Select

Välj egenskaper som ska returneras

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServicePrincipalName

serviceprincipal name

Typ:String
Alias:SPN
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Skip

Ignorerar de första n-objekten och hämtar sedan de återstående objekten.

Typ:UInt64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

IMicrosoftGraphApplication

Utdata

IMicrosoftGraphServicePrincipal