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