你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Set-MsolServicePrincipal

  • 参考
模块:
MSOnline

在 Microsoft Azure Active Directory 中汇报服务主体。

语法

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

说明

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 帮助创建地址列表对象。

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

-AppPrincipalId

指定要更新的服务主体关联的唯一应用程序 ID。

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

指定要更新的服务主体的唯一对象 ID。

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

指定要对其执行操作的租户的唯一 ID。 默认值为当前用户的租户。 此参数仅适用于合作伙伴用户。

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