New-CMTSRule

模組:

ConfigurationManager

建立規則以新增至 [設定動態變數 ] 工作順序步驟。

語法

New-CMTSRule
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSRule
   [-AssetTag <String>]
   [-MacAddress <String>]
   [-SerialNumber <String>]
   [-Uuid <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSRule
   [-DefaultGateway <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSRule
   [-Make <String>]
   [-Model <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSRule
   [-ReferencedVariableName <String>]
   [-ReferencedVariableOperator <VariableOperatorType>]
   [-ReferencedVariableValue <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

使用此 Cmdlet 來建立您新增至 [設定動態變數 ] 工作順序步驟的規則物件。 若要新增規則，請使用 New-CMTSStepSetDynamicVariable 或 Set-CMTSStepSetDynamicVariable Cmdlet。 當工作順序執行此步驟時，它會依序評估動態規則和變數。 當評估特定裝置上的規則時，它可以接著根據這些規則來設定工作順序變數。

規則有四種類型：

• 計算機：評估硬體資產標籤、UUID、序號或 MAC 位址的值。
• 位置：評估預設網路閘道的值。
• 製作和模型：評估計算機製造和模型的值。
• 工作順序變數：新增要評估的工作順序變數、條件和值。

如需詳細資訊，請參閱 動態規則和變數。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：在 Windows PE 中設定下載目的地

此範例會建立下列規則：

IF _SMSTSInWinPE equals "TRUE" THEN SET OSDDownloadDestinationLocationType = "TSCache"

然後，它會將此規則新增至工作順序中此步驟的現有實例。

$tsrule = New-CMTSRule -Variable @{'OSDDownloadDestinationLocationType' = 'TSCache'} -ReferencedVariableName "_SMSTSInWinPE" -ReferencedVariableOperator equals -ReferencedVariableValue TRUE

$tsname = "Default IPU"
$tsstep = "Set Dynamic Variables"

Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsname -StepName $tsstep -AddRule $tsrule

參數

-AssetTag

指定計算機規則類型的資產標籤。 最大值為 255 個字元。

例如，如果您將此值設定為 123456，它會新增下列規則： IF Asset tag equals "123456" THEN

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultGateway

指定 [位置] 規則類型的 [預設網關]。

例如，如果您將此值設定為 192.168.10.1，它會新增下列規則： IF Default gateway equals "192.168.10.1" THEN

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisableWildcardHandling

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

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceWildcardHandling

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

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MacAddress

指定電腦規則類型的 MAC 位址。

例如，如果您將此值設定為 00:11:22:33:44:55，它會新增下列規則： IF MAC address equals "00:11:22:33:44:55" THEN

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Make

指定Make和 Model 規則類型的 Make。 若要設定其他值，請使用 Model 參數。 當兩個值都為 true 時，規則會評估為 true。

您可以使用通配符：

• *：多個字元
• ?：單一字元

例如，如果您將此值設定為 Surface ，並將 Model 設定為 *，則會新增下列規則： IF Make equals "Surface" AND Model equals "*" THEN

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Model

指定 [建立] 和 [模型] 規則類型的 [模型 ]。 若要設定其他值，請使用 Make 參數。 當兩個值都為 true 時，規則會評估為 true。

您可以使用通配符：

• *：多個字元
• ?：單一字元

例如，如果您將此值設定為 * ，並將 Make 設為 Surface，則會新增下列規則： IF Make equals "Surface" AND Model equals "*" THEN

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ReferencedVariableName

指定 [工作順序變數] 規則類型的 [變數]。 它需要您也設定 ReferencedVariableOperator 和 ReferencedVariableValue 參數。

此變數名稱可以是內建的工作順序變數或您建立的自定義工作順序變數。 如需詳細資訊，請 參閱如何在 Configuration Manager 中使用工作順序變數。

例如，如果您設定下列值：

• ReferencedVariableName： OSDRegisteredOrgName
• ReferencedVariableOperator： Equals
• ReferencedVariableValue： Contoso

然後，它會新增下列規則： IF OSDRegisteredOrgName equals "Contoso" THEN

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ReferencedVariableOperator

指定 [工作順序變數] 規則類型的 [條件]。 它需要您也設定 ReferencedVariableName 和 ReferencedVariableValue 參數。 如需可用的運算符，請參閱此參數的接受值清單。

例如，如果您設定下列值：

• ReferencedVariableName： OSDRegisteredOrgName
• ReferencedVariableOperator： Equals
• ReferencedVariableValue： Contoso

然後，它會新增下列規則： IF OSDRegisteredOrgName equals "Contoso" THEN

類型:	VariableOperatorType
接受的值:	Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ReferencedVariableValue

指定 [工作順序變數] 規則類型的 [值]。 您也必須設定 ReferencedVariableName 和 ReferencedVariableOperator 參數。

例如，如果您設定下列值：

• ReferencedVariableName： OSDRegisteredOrgName
• ReferencedVariableOperator： Equals
• ReferencedVariableValue： Contoso

然後，它會新增下列規則： IF OSDRegisteredOrgName equals "Contoso" THEN

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SerialNumber

指定電腦規則類型的序號。

例如，如果您將此值設定為 123456，它會新增下列規則： IF Asset tag equals "123456" THEN

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Uuid

指定電腦規則類型的 UUID。

例如，如果您將此值設定為 de5ba380-f692-45e0-bbd3-0e40543b549e，它會新增下列規則： IF UUID equals "de5ba380-f692-45e0-bbd3-0e40543b549e" THEN

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Variable

指定現有或自定義工作順序變數，以及當規則評估為 true 時，步驟應該設定的相關值。

例如，如果您將此值設定為 @{'OSDDownloadDestinationLocationType' = 'TSCache'}，它會在規則的 之後 THEN 新增下列變數： SET OSDDownloadDestinationLocationType = "TSCache"

若要在相同的哈希表中指定多個變數，請使用分號 () ; 分隔符。 例如：@{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}

類型:	Hashtable
別名:	Variables
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

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

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

None

輸出

IResultObject

相關連結

• Set-CMTSStepSetDynamicVariable
• New-CMTSStepSetDynamicVariable
• 關於工作順序步驟 - 設定動態變數
• 如何在 Configuration Manager 中使用工作順序變數