New-CMDeviceCollectionVariable

模組:

ConfigurationManager

建立裝置集合變數。

Syntax

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 。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

指定要在其中建立變數的裝置集合名稱。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

執行 Cmdlet 之前提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。 您無法將其與 ForceWildcardHandling結合。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

此參數會處理萬用字元，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

指定要在其中建立變數的裝置集合物件。 若要取得此物件，請使用 Get-CMCollection 或 Get-CMDeviceCollection Cmdlet。

Type:	IResultObject
Aliases:	Collection
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IsMask

將此參數設定為 $true ，表示變數值已隱藏。 遮罩值不會顯示在Configuration Manager主控台、WMI 類別上的Value屬性SMS_CollectionVariable或工作順序記錄檔中。 工作順序仍然可以使用 變數。

一旦變數隱藏之後，您就無法取消遮罩變數。 如果您遮罩變數的值，但不想遮罩變數，則必須刪除並重新建立變數。

如果您未包含此參數，預設不會遮罩值。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Value

指定集合變數的值。

Type:	String
Aliases:	VariableValue
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VariableName

指定要建立之集合變數的名稱。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject[]

IResultObject

備註

如需這個傳回物件及其屬性的詳細資訊，請 參閱SMS_CollectionSettings伺服器 WMI 類別。

相關連結

• Get-CMDeviceCollectionVariable
• Remove-CMDeviceCollectionVariable
• Set-CMDeviceCollectionVariable
• Get-CMCollection
• Get-CMDeviceCollection
• New-CMDeviceVariable
• 如何設定工作順序變數