你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-MsolServicePrincipal
更新 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 必须使用以下格式之一：
appNameappName/hostname- 有效的 URL
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-TenantId
指定要对其执行操作的租户的唯一 ID。 默认值为当前用户的租户。 此参数仅适用于合作伙伴用户。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |