Aracılığıyla paylaş

Set-MsolServicePrincipal

  • Başvuru
Modül:
MSOnline

Microsoft Azure Active Directory'de hizmet sorumlusunu güncelleştirir.

Sözdizimi

Set-MsolServicePrincipal
   [-ObjectId <Guid>]
   [-AppPrincipalId <Guid>]
   [-DisplayName <String>]
   [-ServicePrincipalNames <String[]>]
   [-AccountEnabled <Boolean>]
   [-Addresses <RedirectUri[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

Set-MsolServicePrincipal cmdlet'i, Microsoft Azure Active Directory'deki bir hizmet sorumlusunu güncelleştirir. Görünen adı güncelleştirmek, hizmet sorumlusunu etkinleştirmek/devre dışı bırakmak, temsilci seçme için güvenilen, hizmet sorumlusu adları (SPN) veya adresler için kullanılabilir.

Örnekler

Örnek 1: Hizmet sorumlusundaki özellikleri değiştirme

PS C:\> $AppId = (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").AppPrincipalId
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -DisplayName "My Super Application" -ServicePrincipalNames @("MyApp/myapp.com", "MyApp/mysuperapp.com")

Bu komut, belirtilen hizmet sorumlusundaki özellikleri güncelleştirir. Bu örnekte, görünen ad ve SPN'ler için güncelleştirmeleri belirtir. Bu işlem önceki ayarların üzerine yazar.

Örnek 2: Hizmet sorumlusundaki adresleri değiştirme

PS C:\> $a = @()
PS C:\> $a = $a + (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").Addresses
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp1.com")
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp2.com")
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -Addresses $a

Bu komut bir hizmet sorumlusunun adreslerini güncelleştirir. Bu örnekte, New-MsolServicePrincipalAddresses cmdlet'i kullanılarak daha önce oluşturulmuş ("myApp1.com", "myApp2.com") mevcut Adresler hizmet sorumlusuyla ilişkilendirilmiştir.

Parametreler

-AccountEnabled

Bu özellik gelecekte kullanılmak üzere ayrılmıştır.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Addresses

Varolan listenin güncelleştirilip üzerine yazılmasını istediğiniz adresler listesini belirtir. Bu parametreyi belirtmezseniz, mevcut özellik güncelleştirilmez. Boş bir liste belirtirseniz, var olan adresler temizlenir. Adresler listesi nesnesini oluşturmaya yardımcı olması için New-MsolServicePrincipalAddress cmdlet'ini kullanın.

Tür:RedirectUri[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-AppPrincipalId

Güncelleştirilecek hizmet sorumlusuyla ilişkili benzersiz uygulama kimliğini belirtir.

Tür:Guid
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DisplayName

Hizmet sorumlusunun görünen adını belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ObjectId

Güncelleştirilecek hizmet sorumlusunun benzersiz nesne kimliğini belirtir.

Tür:Guid
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ServicePrincipalNames

Varolanın güncelleştirilip üzerine yazıldığı SPN'lerin listesini belirtir. Bu parametreyi belirtmezseniz, mevcut özellik güncelleştirilmez. Boş bir liste belirtirseniz, hizmet sorumlusunun AppId değerini içeren SPN dışında mevcut SPN'ler temizlenir. SPN aşağıdaki biçimlerden birini kullanmalıdır:

  • appName
  • appName/hostname
  • geçerli bir URL
Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:Guid
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False