共用方式為


Set-SCCustomProperty

修改自訂屬性的屬性。

Syntax

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>]

Description

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® Domain Services 網域使用者或群組新增至使用者角色。 以下列格式指定成員:

  • 網域\使用者
  • User
  • 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 提示) 效能和資源優化提示的識別碼。 此參數可讓您稽核 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
  • 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

表示作業會以非同步方式執行,讓控制項立即返回命令殼層。

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