Set-CMDeviceCollectionVariable
設定裝置集合變數。
語法
Set-CMDeviceCollectionVariable
-InputObject <IResultObject>
[-IsMask <Boolean>]
[-NewVariableName <String>]
[-NewVariableValue <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMDeviceCollectionVariable
-CollectionId <String>
[-IsMask <Boolean>]
[-NewVariableName <String>]
[-NewVariableValue <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMDeviceCollectionVariable
-CollectionName <String>
[-IsMask <Boolean>]
[-NewVariableName <String>]
[-NewVariableValue <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
使用此 Cmdlet 來變更裝置集合變數。
默認集合不能有變數。 您目標的任何集合都應該有以月臺碼開頭的識別碼，而不是 SMS。
如需詳細資訊，請 參閱如何設定工作順序變數。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：變更變數名稱
第一個命令會取得名為 Device 的裝置集合物件，並將它儲存在 $Collection 變數中。
第二個命令會將集合變數 testTS 的名稱變更為 NewVariable。
$Collection = Get-CMCollection -Name "Device"
Set-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -NewVariableName "NewVariable"範例 2：變更變數值
此命令會變更 Device 集合上變數 testTS 的值。 它會將新的變數值設定為 12。
Set-CMDeviceCollectionVariable -CollectionName "Device" -VariableName "testTS" -NewVariableValue 12參數
-CollectionId
指定要設定變數之裝置集合的標識碼。 這個值是 CollectionID 屬性， 例如 。 XYZ00012 因為您無法在預設集合上設定變數，所以此值的開頭是月臺碼，而不是 SMS。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CollectionName
指定要設定變數的裝置集合名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
指定要設定變數的裝置集合物件。 若要取得此物件，請使用 Get-CMCollection 或 Get-CMDeviceCollection Cmdlet。
| 類型: | IResultObject |
| 別名: | Collection |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-IsMask
將此參數設定為 $true ，表示變數值已隱藏。 遮罩值不會顯示在 Configuration Manager 控制台、WMI 類別上的 Value 屬性 SMS_CollectionVariable或工作順序記錄檔中。 工作順序仍然可以使用 變數。
一旦變數隱藏之後，您就無法取消遮罩變數。 如果您遮罩變數的值，但不想遮罩變數，則必須刪除並重新建立變數。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-NewVariableName
指定集合變數的新名稱。 使用此參數來重新命名變數。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-NewVariableValue
指定集合變數的新值。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-VariableName
指定要變更的集合變數名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object
備註
若要設定變數優先順序，請使用 Set-CMCollection Cmdlet 搭配 VariablePriority 參數。 若要檢視目前的變數優先順序，請使用 Get-CMCollectionSetting Cmdlet。