{"content":"
","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/zh-tw/powershell/","_op_gitContributorInformation":{"author":{"display_name":"Banreet Kaur","id":"92906285","name":"Banreet","profile_url":"https://github.com/Banreet"},"contributors":[{"display_name":"Aaron Czechowski","id":"26784733","name":"aczechowski","profile_url":"https://github.com/aczechowski"}],"update_at":"2026/8/3","updated_at_date_time":"2026-08-03T08:25:56.3487582Z"},"_path":"module/configurationmanager/new-cmtsrule.json","_rel":"../../","_tocRel":"../sccm-ps/toc.json","apiPlatform":"powershell","author":"Banreet","breadcrumb_path":"/powershell/sccm/bread/toc.json","canonical_url":"https://learn.microsoft.com/zh-tw/powershell/module/configurationmanager/new-cmtsrule?view=sccm-ps","content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell-ref/blob/main/sccm-ps/ConfigurationManager/New-CMTSRule.md","default_moniker":"sccm-ps","depot_name":"MSDN.sccm-powershell","document_id":"8dc3993b-0ea5-815f-4825-c8540197642f","document_version_independent_id":"92603e7a-e3d5-5623-69f5-bdb2be242fe0","external help file":"AdminUI.PS.dll-Help.xml","feedback_product_url":"https://feedbackportal.microsoft.com/feedback/forum/4669adfc-ee1b-ec11-b6e7-0022481f8472","feedback_system":"Standard","git_commit_id":"48cf632fb4b9ad92060012681a500478254de750","gitcommit":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/48cf632fb4b9ad92060012681a500478254de750/sccm-ps/ConfigurationManager/New-CMTSRule.md","github_contributors":["aczechowski"],"locale":"zh-tw","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"09/01/2021","ms.service":"microsoft-endpoint-configuration-manager","ms.subservice":"other","ms.topic":"reference","online version":"","open_to_public_contributors":true,"original_content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/live/sccm-ps/ConfigurationManager/New-CMTSRule.md","original_content_git_url_template":"{repo}/blob/{branch}/sccm-ps/ConfigurationManager/New-CMTSRule.md","PlatyPS schema version":"2.0.0","products":["https://authoring-docs-microsoft.poolparty.biz/devrel/f1499c3b-793f-48c3-a9ce-20285bcc6541"],"site_name":"Docs","titleSuffix":"Configuration Manager","uhfHeaderId":"MSDocsHeader-Powershell","updated_at":"2026-08-03 08:25 AM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmtsrule","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSRule","schemaType":"PowershellCmdlet","summary":"

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

\n","uid":"ConfigurationManager.New-CMTSRule"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMTSRule":{"href":"new-cmtsrule","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSRule","schemaType":"PowershellCmdlet","summary":"

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

\n","uid":"ConfigurationManager.New-CMTSRule"}},"description":"

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

\n

規則有四種類型：

\n\n

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

\n
\n

注意事項

\n

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

\n
\n","examples":[{"code":"$tsrule = New-CMTSRule -Variable @{'OSDDownloadDestinationLocationType' = 'TSCache'} -ReferencedVariableName \"_SMSTSInWinPE\" -ReferencedVariableOperator equals -ReferencedVariableValue TRUE\n\n$tsname = \"Default IPU\"\n$tsstep = \"Set Dynamic Variables\"\n\nSet-CMTSStepSetDynamicVariable -TaskSequenceName $tsname -StepName $tsstep -AddRule $tsrule","description":"","summary":"

此範例會建立下列規則：

\n

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

\n

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

\n","title":"範例 1：在 Windows PE 中設定下載目的地"}],"inputs":[{"description":"","name":"None\n"}],"links":[{"href":"set-cmtsstepsetdynamicvariable","text":"Set-CMTSStepSetDynamicVariable"},{"href":"new-cmtsstepsetdynamicvariable","text":"New-CMTSStepSetDynamicVariable"},{"href":"/mem/configmgr/osd/understand/task-sequence-steps#BKMK_SetDynamicVariables","text":"關於工作順序步驟 - 設定動態變數"},{"href":"/mem/configmgr/osd/understand/using-task-sequence-variables","text":"如何在 Configuration Manager 中使用工作順序變數"}],"module":"ConfigurationManager","name":"New-CMTSRule","notes":"","outputs":[{"description":"","name":"IResultObject\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"

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

\n

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

\n","name":"AssetTag","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"cf","defaultValue":"None","description":"

執行 Cmdlet 之前提示您確認。

\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

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

\n

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

\n","name":"DefaultGateway","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

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

\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

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

\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

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

\n

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

\n","name":"MacAddress","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

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

\n

您可以使用通配符：

\n\n

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

\n","name":"Make","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

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

\n

您可以使用通配符：

\n\n

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

\n","name":"Model","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

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

\n

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

\n

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

\n\n

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

\n","name":"ReferencedVariableName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

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

\n

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

\n\n

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

\n","name":"ReferencedVariableOperator","parameterValueGroup":"Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike","position":"Named","type":"VariableOperatorType\n"},{"aliases":"","defaultValue":"None","description":"

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

\n

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

\n\n

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

\n","name":"ReferencedVariableValue","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

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

\n

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

\n","name":"SerialNumber","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

指定電腦規則類型的 UUID。

\n

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

\n","name":"Uuid","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Variables","defaultValue":"None","description":"

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

\n

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

\n

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

\n","isRequired":true,"name":"Variable","parameterValueGroup":"","position":"Named","type":"Hashtable\n"},{"aliases":"wi","defaultValue":"None","description":"

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

\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"

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

\n","syntaxes":["New-CMTSRule -Variable [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n []","New-CMTSRule [-AssetTag ] [-MacAddress ] [-SerialNumber ] [-Uuid ]\n -Variable [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n []","New-CMTSRule [-DefaultGateway ] -Variable [-DisableWildcardHandling]\n [-ForceWildcardHandling] [-WhatIf] [-Confirm] []","New-CMTSRule [-Make ] [-Model ] -Variable [-DisableWildcardHandling]\n [-ForceWildcardHandling] [-WhatIf] [-Confirm] []","New-CMTSRule [-ReferencedVariableName ] [-ReferencedVariableOperator ]\n [-ReferencedVariableValue ] -Variable [-DisableWildcardHandling] [-ForceWildcardHandling]\n [-WhatIf] [-Confirm] []"],"uid":"ConfigurationManager.New-CMTSRule","hideEdit":true,"ms.translationtype":"MT","ms.contentlocale":"zh-tw","loc_version":"2024-08-21T21:18:36.7205003Z","loc_source_id":"Github-72476255#live","loc_file_id":"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/New-CMTSRule.md","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmtsrule","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSRule","schemaType":"PowershellCmdlet","summary":"

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

\n","uid":"ConfigurationManager.New-CMTSRule"}],"canonical_url":"https://learn.microsoft.com/zh-tw/powershell/module/configurationmanager/new-cmtsrule?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/zh-tw/powershell/module/configurationmanager/new-cmtsrule?view=sccm-ps"},"pageMetadata":"使用此 Cmdlet 來建立您新增至 [設定動態變數 ] 工作順序步驟的規則物件。 若要新增規則，請使用 New-CMTSStepSetDynamicVariable 或 Set-CMTSStepSetDynamicVariable Cmdlet。 當工作順序執行此步驟時，它會依序評估動態規則和變數。 當評估特定裝置上的規則時，它可以接著根據這些規則來設定工作順序變數。

\n

規則有四種類型：

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

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

\n
\n

注意事項

\n

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

\n
\n\" />\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n建立規則以新增至 [設定動態變數 ] 工作順序步驟。

\n\" />\r\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n []\" />\r\n] [-MacAddress ] [-SerialNumber ] [-Uuid ]\n -Variable [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n []\" />\r\n] -Variable [-DisableWildcardHandling]\n [-ForceWildcardHandling] [-WhatIf] [-Confirm] []\" />\r\n] [-Model ] -Variable [-DisableWildcardHandling]\n [-ForceWildcardHandling] [-WhatIf] [-Confirm] []\" />\r\n] [-ReferencedVariableOperator ]\n [-ReferencedVariableValue ] -Variable [-DisableWildcardHandling] [-ForceWildcardHandling]\n [-WhatIf] [-Confirm] []\" />\r\n\r\n","themesRelativePathToOutputRoot":"_themes/"}