Get-MsolServicePrincipal

  • Başvuru
Modül:
MSOnline

Azure Active Directory'den hizmet sorumlularını alır.

Syntax

Get-MsolServicePrincipal
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

Get-MsolServicePrincipal cmdlet'i, Azure Active Directory'den bir hizmet sorumlusu veya hizmet sorumlularının listesini alır.

Örnekler

Örnek 1: Tüm hizmet sorumlularını görüntüleme

PS C:\> Get-MsolServicePrincipal

Bu komut, kuruluşun kiracısındaki tüm mevcut hizmet sorumlularını görüntüler.

Örnek 2: Ad kullanarak hizmet sorumlularını alma

PS C:\> Get-MsolServicePrincipal -ServicePrincipalName "MyApp"

Bu komut, MyApp ile başlayan hizmet sorumlusu adına sahip tüm mevcut hizmet sorumlularını alır. Bu, hizmet sorumlusu adının eğik çizgiye kadar appClass bölümünün tam eşleşmesidir.

Örnek 3: Hizmet sorumlusu alma

PS C:\> Get-MsolServicePrincipal -AppPrincipalId 5e964d2f-e384-4292-ae55-dd24c89cc53b

Bu komut, belirli bir uygulama sorumlusu kimliğine sahip bir hizmet sorumlusu alır.

Parametreler

-All

Bu cmdlet'in tüm sonuçları döndürdüğünü gösterir. MaxResults parametresiyle birlikte belirtmeyin.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AppPrincipalId

Alınacak hizmet sorumlusunun benzersiz uygulama kimliğini belirtir.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaxResults

Bu cmdlet'in döndürdüğü en fazla sonuç sayısını belirtir. Varsayılan değer 500'dür.

Type:Int32
Position:Named
Default value:500
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Alınacak hizmet sorumlusunun benzersiz nesne kimliğini belirtir.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SearchString

Hizmet sorumlusu adlarıyla eşleşecek bir dize belirtir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServicePrincipalName

Alınacak hizmet sorumlusunun veya hizmet sorumlularının adını belirtir. SPN aşağıdaki biçimlerden birini kullanmalıdır:

  • appName
  • appName/hostname
  • geçerli bir URL

AppName uygulamanın adını, konak adı ise uygulamanın URI yetkilisini temsil eder.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

İşlemin gerçekleştirildiği kiracının benzersiz kimliğini belirtir. Varsayılan değer geçerli kullanıcının kiracısıdır. Bu parametre yalnızca iş ortağı kullanıcıları için geçerlidir.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Çıkışlar

Microsoft.Online.Administration.ServicePrincipal[]

Bu cmdlet, Azure Active Directory'den bir hizmet sorumlusu veya hizmet sorumlularının listesini döndürür. Her hizmet sorumlusu aşağıdaki bilgileri içerir:

  • Objectıd. Hizmet sorumlusunun benzersiz tanımlayıcısı.
  • AppPrincipalId. Hizmet sorumlusunun uygulama tanımlayıcısı.
  • Displayname. Hizmet sorumlusunun kolay adı.
  • Serviceprincipalname. Hizmet sorumlusuyla ilişkili hizmet sorumlusu adlarının (SPN) listesi.
  • AccountEnabled. Hesabın etkin olup olmadığını gösteren değer.