New-SCCustomProperty

在 VMM 数据库中创建自定义属性定义。

语法

New-SCCustomProperty
   [-Name] <String>
   [-Description <String>]
   -AddMember <CustomPropertyObjectType[]>
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

说明

New-SCCustomProperty cmdlet 在 Virtual Machine Manager (VMM) 数据库中创建自定义属性定义。

可以为以下对象类型创建自定义属性:

  • VM
  • 模板
  • VMHost
  • HostCluster
  • VMHostGroup
  • ServiceTemplate
  • ServiceInstance
  • ComputerTier

示例

示例 1:创建自定义属性

PS C:\> $CustomProp = New-SCCustomProperty -Name "Cost Center" -AddMember "VM"
PS C:\> $CustomProp

第一个命令使用 VM 作为成员创建名为 Cost Center 的自定义属性对象,并将对象存储在$CustomProp变量中。

第二个命令显示存储在用户$CustomProp中的自定义属性对象的属性。

参数

-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

-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:0
Default value:None
Required:True
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

-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