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