Set-SCCustomPropertyValue
更新自定义属性的值。
语法
Set-SCCustomPropertyValue
-CustomProperty <CustomProperty>
-InputObject <ClientObject>
-Value <String>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Set-SCCustomPropertyValue
-CustomProperty <CustomProperty>
-Value <String>
-JobGroup <Guid>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] 说明
Set-SCCustomPropertyValue cmdlet 更新自定义属性的值。
示例
示例 1：设置虚拟机上自定义属性的值
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomPropertyValue -InputObject $VM -CustomProperty $CustomProp -Value "123"第一个命令获取名为 VM01 的虚拟机对象，并将该对象存储在$VM变量中。
第二个命令获取名为 Cost Center 的自定义属性对象，并将该对象存储在$CustomProp变量中。
最后一个命令将存储在 $CustomProp（成本中心）中存储的虚拟机$VM（VM01）中的自定义属性的值设置为 123。
参数
-CustomProperty
指定自定义属性对象。
| 类型: | CustomProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-InputObject
指定要为其检索或更改其值的属性分配的对象。
| 类型: | ClientObject |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-JobGroup
指定一系列命令的标识符，该命令将在包含相同作业组标识符的最终命令运行之前作为集运行。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-JobVariable
指定在此参数命名的变量中跟踪和存储作业进度。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-OnBehalfOfUser
指定用户名。 此 cmdlet 代表此参数指定的用户运行。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-OnBehalfOfUserRole
指定用户角色。 若要获取用户角色，请使用 Get-SCUserRole cmdlet。 此 cmdlet 代表此参数指定的用户角色运行。
| 类型: | UserRole |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PROTipID
指定触发此操作的性能和资源优化提示（PRO 提示）的 ID。 此参数允许你审核 PRO 提示。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RunAsynchronously
指示作业以异步方式运行，以便控件立即返回到命令行界面。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Value
指定用于对对象或属性进行特性化的字符串。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
备注
- 需要 VMM 自定义属性对象，可以使用 Get-SCCustomProperty cmdlet 来检索该对象。