Get-AzADServicePrincipal

Hizmet sorumlularından varlıkları listeler veya anahtara göre hizmet sorumlularından varlık alır

Syntax

EmptyParameterSet (Varsayılan)

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

Hizmet sorumlularından varlıkları listeler veya anahtara göre hizmet sorumlularından varlık alır

Örnekler

Örnek 1: Görünen ada göre hizmet sorumlusu alma

Get-AzADServicePrincipal -DisplayName $name

Görünen ada göre hizmet sorumlusu alma

Örnek 2: Hizmet sorumlusu görünen adını arama ile başlar

Get-AzADServicePrincipal -DisplayNameStartsWith $prefix

Hizmet sorumlusu görünen adı için arama ile başlar

Örnek 3: Hizmet sorumlularını listeleme

Get-AzADServicePrincipal -First 10 -Select Tags -AppendSelected

Varsayılan özelliklerden sonra ilk 10 hizmet sorumlusunu listeleyin ve 'Tags' özelliğini ekleyin: 'DisplayName', 'Id', 'DeletedDateTime', 'ServicePrincipalNames', 'AppId'

Örnek 4: Uygulama kimliğine göre hizmet sorumlusu alma

Get-AzADServicePrincipal -ApplicationId $appId

Uygulama kimliğine göre hizmet sorumlusu alma

Örnek 5: İşlem hattı girişlerine göre hizmet sorumlusu alma

Get-AzADApplication -DisplayName $name | Get-AzADServicePrincipal

İşlem hattı girişlerine göre hizmet sorumlusu alma

Örnek 6: Filtre ile hizmet sorumlusu alma

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

Filtre ile hizmet sorumlusu alma

Örnek 7: Bir değişkene OdataCount atama

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

Bir değişkene OdataCount atama

Parametreler

-AppendSelected

Bu anahtar açıkken varsayılan özelliklerle seçilen ekleme özellikleri, yalnızca '-Select' parametresiyle çalışır.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-ApplicationId

serviceprincipal uygulama kimliği

Parametre özellikleri

Tür:Guid
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:AppId

Parametre kümeleri

ApplicationIdParameterSet
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-ApplicationObject

Hizmet sorumlusu nesnesi, işlem hattı girişi olarak kullanılabilir.

Parametre özellikleri

Tür:IMicrosoftGraphApplication
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ApplicationObjectParameterSet
Position:Named
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-ConsistencyLevel

İstenen tutarlılık düzeyini gösterir. Belge URL'si: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

EmptyParameterSet
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Count

Öğe sayısını dahil et

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

EmptyParameterSet
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-CountVariable

Koleksiyondaki toplam öğe sayısının sayısını belirtir. Varsayılan olarak, bu değişken genel kapsamda ayarlanır.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

EmptyParameterSet
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Parametre özellikleri

Tür:PSObject
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:AzContext, AzureRmContext, AzureCredential

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-DisplayName

serviceprincipal görünen adı

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DisplayNameParameterSet
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-DisplayNameBeginsWith

serviceprincipal görünen adı ile başlar

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:DisplayNameStartsWith, SearchString

Parametre kümeleri

SearchStringParameterSet
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Filter

Öğeleri özellik değerlerine göre filtreleyin, filtre sorgusu hakkında daha fazla ayrıntı için lütfen bkz: https://learn.microsoft.com/en-us/graph/filter-query-parameter

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

EmptyParameterSet
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-First

Yalnızca ilk 'n' nesnelerini alır.

Parametre özellikleri

Tür:UInt64
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-ObjectId

anahtar: servicePrincipal kimliği

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:ServicePrincipalId, Id

Parametre kümeleri

ObjectIdParameterSet
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Orderby

Öğeleri özellik değerlerine göre sıralama

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

EmptyParameterSet
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

Öğeleri arama tümceciklerine göre arama

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

EmptyParameterSet
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Select

Döndürülecek özellikleri seçin

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-ServicePrincipalName

serviceprincipal adı

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:SPN

Parametre kümeleri

SPNParameterSet
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Skip

İlk 'n' nesnelerini yoksayar ve kalan nesneleri alır.

Parametre özellikleri

Tür:UInt64
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

IMicrosoftGraphApplication

Çıkışlar

IMicrosoftGraphServicePrincipal