New-CMDeviceCollectionVariable
建立裝置集合變數。
語法
New-CMDeviceCollectionVariable
-InputObject <IResultObject>
[-IsMask <Boolean>]
[-Value <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMDeviceCollectionVariable
-CollectionId <String>
[-IsMask <Boolean>]
[-Value <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMDeviceCollectionVariable
-CollectionName <String>
[-IsMask <Boolean>]
[-Value <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
使用此 Cmdlet 建立裝置集合變數。 您可以使用裝置集合變數來定義自定義工作順序變數及其相關聯的值，供集合中的裝置使用。 工作順序變數是一組名稱和值組，可在工作順序部署至特定集合時，提供設定和自定義工作順序步驟的機制。
默認集合不能有變數。 您目標的任何集合都應該有以月臺碼開頭的識別碼，而不是 SMS。
如需詳細資訊，請 參閱如何設定工作順序變數。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：建立裝置集合變數
第一個命令會取得名為 Device 的裝置集合物件，並將它儲存在 $Collection 變數中。
第二個命令會為儲存在 $Collection 中的集合物件建立名為testTS的集合變數，其值為test001。
$Collection = Get-CMCollection -Name "Device"
New-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Value "test001"參數
-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 |
-Value
指定集合變數的值。
| 類型: | String |
| 別名: | VariableValue |
| 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
輸出
IResultObject[]
IResultObject
備註
如需這個傳回物件及其屬性的詳細資訊，請 參閱SMS_CollectionSettings伺服器 WMI 類別。