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>] 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@Domain
- Domain\LabGroupAlias
- LabGroupAlias
實驗室群組別名是Active Directory網域服務安全組，而不是電子郵件別名。
| 類型: | CustomPropertyObjectType[] |
| 接受的值: | VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CustomProperty
指定自訂屬性物件。
| 類型: | CustomProperty |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Description
指定指定之物件的描述。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-JobVariable
指定作業進度會追蹤並儲存在此參數所命名的變數中。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定 VMM 物件的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PROTipID
指定觸發此動作之效能和資源優化提示 （PRO 提示） 的識別碼。 此參數可讓您稽核 PRO 秘訣。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RemoveMember
指定此 Cmdlet 從具有成員資格概念的 VMM 物件中移除的成員陣列，例如群組。 例如，此 Cmdlet 可以從使用者角色中移除一或多個 Active Directory Domain Services 網域使用者或群組。 以下欄格式指定成員：
- 網域\使用者
- 使用者
- User@Domain
- Domain\LabGroupAlias
- LabGroupAlias
實驗室群組別名是Active Directory網域服務安全組，而不是電子郵件別名。
| 類型: | CustomPropertyObjectType[] |
| 接受的值: | VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RunAsynchronously
表示作業會以異步方式執行，讓控件立即返回命令殼層。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-VMMServer
指定 VMM 伺服器物件。
| 類型: | ServerConnection |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |