你当前正在访问 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

保留此属性供将来使用。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Addresses

指定用于更新和覆盖现有列表的地址列表。 如果未指定此参数，则不会更新现有属性。 如果指定空列表，则会清除现有地址。 使用 New-MsolServicePrincipalAddress cmdlet 帮助创建 Addresses 列表对象。

类型:RedirectUri[]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-AppPrincipalId

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

类型:Guid
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DisplayName

指定服务主体的显示名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ObjectId

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

类型: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

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

类型:Guid
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False