Set-SCCustomPropertyValue
更新自訂屬性的值。
語法
Set-SCCustomPropertyValue
-CustomProperty <CustomProperty>
-InputObject <ClientObject>
-Value <String>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Set-SCCustomPropertyValue
-CustomProperty <CustomProperty>
-Value <String>
-JobGroup <Guid>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
Set-SCCustomPropertyValue Cmdlet 會更新自定義屬性的值。
範例
範例 1：設定虛擬機上自定義屬性的值
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomPropertyValue -InputObject $VM -CustomProperty $CustomProp -Value "123"第一個命令會取得名為 VM01 的虛擬機物件，並將物件儲存在$VM變數中。
第二個命令會取得名為 Cost Center 的自定義屬性物件，並將物件儲存在$CustomProp變數中。
最後一個命令會將儲存在 $CustomProp （成本中心） 中儲存在 $VM （VM01） 之虛擬機的自定義屬性值設定為 123。
參數
-CustomProperty
指定自訂屬性物件。
| 類型: | CustomProperty |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-InputObject
指定指派要擷取或變更其值之屬性的物件。
| 類型: | ClientObject |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-JobGroup
指定一系列命令的標識碼，這些命令將在包含相同作業群組標識符的執行的最後一個命令之前，以集合的形式執行。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-JobVariable
指定作業進度會追蹤並儲存在此參數所命名的變數中。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OnBehalfOfUser
指定用戶名稱。 這個 Cmdlet 代表此參數指定的用戶運作。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OnBehalfOfUserRole
指定使用者角色。 若要取得使用者角色，請使用 Get-SCUserRole Cmdlet。 這個 Cmdlet 代表此參數指定的使用者角色運作。
| 類型: | UserRole |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PROTipID
指定觸發此動作之效能和資源優化提示 （PRO 提示） 的識別碼。 此參數可讓您稽核 PRO 秘訣。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RunAsynchronously
表示作業會以異步方式執行，讓控件立即返回命令殼層。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Value
指定用來屬性物件或屬性的字串。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
備註
- 需要 VMM 自定義屬性物件，可以使用 Get-SCCustomProperty Cmdlet 來擷取。