共用方式為

Set-MsolServicePrincipal

  • 參考
模組:
MSOnline

更新 Microsoft Azure Active Directory 中的服務主體。

語法

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

Description

Set-MsolServicePrincipal Cmdlet 會更新 Microsoft Azure Active Directory 中的服務主體。 這可用來更新顯示名稱、啟用/停用服務主體、受信任委派、服務主體名稱 (SPN) 或位址。

範例

範例 1：變更服務主體的屬性

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")

此命令會更新指定之服務主體的屬性。 在此範例中，它會指定顯示名稱和SPN的更新。 這會覆寫任何先前的設定。

範例 2：變更服務主體上的位址

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

此命令會更新服務主體的位址。 在此範例中，先前使用 New-MsolServicePrincipalAddresses Cmdlet 建立 (“myApp1.com”、“myApp2.com”) 的現有位址會與服務主體相關聯。

參數

-AccountEnabled

這個屬性保留給未來的版本使用。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Addresses

指定要用來更新和覆寫現有清單的地址清單。 如果您未指定此參數，則不會更新現有的屬性。 如果您指定空的清單，則會清除現有的位址。 使用 New-MsolServicePrincipalAddress Cmdlet 來協助建立 Addresses 清單物件。

類型:RedirectUri[]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-AppPrincipalId

指定要更新之服務主體相關聯的唯一應用程式識別碼。

類型:Guid
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-DisplayName

指定服務主體的顯示名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ObjectId

指定要更新之服務主體的唯一對象識別碼。

類型:Guid
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ServicePrincipalNames

指定要用來更新和覆寫現有SPN的清單。 如果您未指定此參數，則不會更新現有的屬性。 如果您指定空的清單，則會清除現有的SPN，但包含服務主體 AppId 值的SPN除外。 SPN 必須使用下列其中一種格式：

  • appName
  • appName/hostname
  • 有效的 URL
類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-TenantId

指定要在其中執行作業之租使用者的唯一標識符。 預設值為目前使用者的租使用者。 此參數僅適用於合作夥伴使用者。

類型:Guid
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False