共用方式為

Set-MsolServicePrincipal

  • 參考
模組:
MSOnline

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

Syntax

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

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

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

-Addresses

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

Type:RedirectUri[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AppPrincipalId

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

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

-DisplayName

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

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

-ObjectId

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

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

-ServicePrincipalNames

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

  • appName
  • appName/hostname
  • 有效的 URL
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

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

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