Set-SCCustomProperty
修改自定义属性的属性。
语法
Set-SCCustomProperty
[-VMMServer <ServerConnection>]
-CustomProperty <CustomProperty>
[-Name <String>]
[-Description <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Set-SCCustomProperty
[-VMMServer <ServerConnection>]
-CustomProperty <CustomProperty>
[-Name <String>]
[-Description <String>]
-AddMember <CustomPropertyObjectType[]>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Set-SCCustomProperty
[-VMMServer <ServerConnection>]
-CustomProperty <CustomProperty>
[-Name <String>]
[-Description <String>]
-RemoveMember <CustomPropertyObjectType[]>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
说明
Set-SCCustomProperty cmdlet 修改自定义属性的属性。 可修改的属性包括:
- 自定义属性的说明
- 自定义属性的名称
- 将成员添加到自定义属性
- 从自定义属性中删除成员
有关创建自定义属性的信息,请键入 Get-Help New-SCCustomProperty -Detailed
。
示例
示例 1:将成员添加到自定义属性
PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomProperty -CustomProperty $CustomProp -AddMember "VMHost"
第一个命令获取名为 Cost Center 的自定义属性对象,并将对象存储在$CustomProp变量中。
第二个命令将 VMHost 成员添加到存储在$CustomProp中的自定义属性。
示例 2:从自定义属性中删除成员
PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomProperty -CustomProperty $CustomProp -RemoveMember "VM"
第一个命令获取名为 Cost Center 的自定义属性对象,并将对象存储在$CustomProp变量中。
第二个命令从存储在$CustomProp中的自定义属性对象中删除 VM 成员。
参数
-AddMember
指定此 cmdlet 添加到具有成员概念的对象(如组)的成员数组。 例如,此 cmdlet 可以将一个或多个 Active Directory® 域服务域用户或组添加到用户角色。 使用以下格式指定成员:
- 域\用户
- 用户
- User@Domain
- Domain\LabGroupAlias
- LabGroupAlias
实验室组别名是Active Directory 域服务安全组,而不是电子邮件别名。
Type: | CustomPropertyObjectType[] |
Accepted values: | VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomProperty
指定自定义属性对象。
Type: | CustomProperty |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Description
为指定对象指定描述。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
指定跟踪作业进度,并将其存储在此参数命名的变量中。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定 VMM 对象的名称。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
指定触发此操作 (PRO 提示) 的性能和资源优化提示的 ID。 此参数允许审核 PRO 提示。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveMember
指定此 cmdlet 从具有成员身份概念的 VMM 对象(如组)中删除的成员数组。 例如,此 cmdlet 可以从用户角色中删除一个或多个Active Directory 域服务域用户或组。 使用以下格式指定成员:
- 域\用户
- 用户
- User@Domain
- Domain\LabGroupAlias
- LabGroupAlias
实验室组别名是Active Directory 域服务安全组,而不是电子邮件别名。
Type: | CustomPropertyObjectType[] |
Accepted values: | VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
指示作业异步运行,以便控件立即返回到命令 shell。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMMServer
指定VMM 服务器对象。
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |