New-CMTSRule
建立規則以加入 設定的動態變數 任務順序步驟。
Syntax
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 來建立一個規則物件，並將其新增至 設定的動態變數 任務順序步驟。 若要新增規則，請使用 CMTSStepSetDynamicVariable 或 CMTSStepSetDynamicVariable Cmdlet。 當任務循序執行此步驟時，它會依順序評估動態規則和變數。 當它評估特定裝置上的規則時，它就可以根據這些規則來設定任務順序變數。
有四種類型的規則：
- 電腦：評估硬體資產標記、UUID、序號碼或 MAC 位址的值。
- 位置：評估預設閘道的值。
- Make And model：評估電腦的 Make 和 model 的值。
- 任務順序變數：新增要評估的任務順序變數、條件和值。
如需詳細資訊，請參閱 動態規則和變數。
注意
從 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
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultGateway
指定位置規則類型的預設閘道。
例如，如果您將這個值設定為 192.168.10.1 ，它會新增下列規則： IF Default gateway equals "192.168.10.1" THEN
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MacAddress
指定電腦規則類型的MAC 位址。
例如，如果您將這個值設定為 00:11:22:33:44:55 ，它會新增下列規則： IF MAC address equals "00:11:22:33:44:55" THEN
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Make
指定 make和模型規則類型的制定。 若要設定其他值，請使用 Model 參數。 當兩個值都為 true 時，規則會評估為 true。
您可以使用萬用字元：
*：多個字元?：單一字元
例如，如果您將這個值設定為 Surface 及 模型 設定為 * ，它會新增下列規則： IF Make equals "Surface" AND Model equals "*" THEN
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReferencedVariableName
指定任務順序變數規則類型的變數。 它需要您同時設定 ReferencedVariableOperator 及 ReferencedVariableValue 參數。
這種變數名稱可以是內建的任務順序變數或您建立的自訂。 如需詳細資訊，請參閱 如何在 Configuration Manager 中使用任務順序變數。
例如，如果您設定下列值：
- ReferencedVariableName：
OSDRegisteredOrgName - ReferencedVariableOperator：
Equals - ReferencedVariableValue：
Contoso
然後，它會新增下列規則： IF OSDRegisteredOrgName equals "Contoso" THEN
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReferencedVariableOperator
指定任務順序變數規則類型的條件。 它需要您同時設定 ReferencedVariableName 及 ReferencedVariableValue 參數。 如需可用的操作員，請參閱此參數的公認值清單。
例如，如果您設定下列值：
- ReferencedVariableName：
OSDRegisteredOrgName - ReferencedVariableOperator：
Equals - ReferencedVariableValue：
Contoso
然後，它會新增下列規則： IF OSDRegisteredOrgName equals "Contoso" THEN
| Type: | VariableOperatorType |
| Accepted values: | Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReferencedVariableValue
指定任務順序變數規則類型的值。 它需要您同時設定 ReferencedVariableName 及 ReferencedVariableOperator 參數。
例如，如果您設定下列值：
- ReferencedVariableName：
OSDRegisteredOrgName - ReferencedVariableOperator：
Equals - ReferencedVariableValue：
Contoso
然後，它會新增下列規則： IF OSDRegisteredOrgName equals "Contoso" THEN
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SerialNumber
指定電腦規則類型的序號碼。
例如，如果您將這個值設定為 123456 ，它會新增下列規則： IF Asset tag equals "123456" THEN
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Uuid
指定電腦規則類型的UUID 。
例如，如果您將這個值設定為 de5ba380-f692-45e0-bbd3-0e40543b549e ，它會新增下列規則： IF UUID equals "de5ba380-f692-45e0-bbd3-0e40543b549e" THEN
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Variable
指定當規則評估為 true 時，應設定的現有或自訂任務順序變數和相關聯的值。
例如，如果您將這個值設定為 @{'OSDDownloadDestinationLocationType' = 'TSCache'} ，它會在規則後面新增下列變數 THEN ： SET OSDDownloadDestinationLocationType = "TSCache"
若要在同一個雜湊表中指定多個變數，請使用分號 (;) 分隔符號。 例如：@{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}
| Type: | Hashtable |
| Aliases: | Variables |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-模型
指定Make 和 Model規則類型的模型。 若要設定其他值，請使用 Make 參數。 當兩個值都為 true 時，規則會評估為 true。
您可以使用萬用字元：
*：多個字元?：單一字元
例如，如果您將此值設為 * 及 做 為 Surface ，它會新增下列規則： IF Make equals "Surface" AND Model equals "*" THEN
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
無
輸出
IResultObject