{"content":"<div></div>","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/pt-br/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":"25/06/2026","updated_at_date_time":"2026-06-25T23:34:34.5161186Z"},"_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/pt-br/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":"pt-br","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"09/01/2021","ms.service":"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-06-25 11:34 PM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmtsrule","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSRule","schemaType":"PowershellCmdlet","summary":"<p>Crie uma regra para adicionar a um passo de sequência de <strong>tarefas Definir Variáveis Dinâmicas</strong> .</p>\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":"<p>Crie uma regra para adicionar a um passo de sequência de <strong>tarefas Definir Variáveis Dinâmicas</strong> .</p>\n","uid":"ConfigurationManager.New-CMTSRule"}},"description":"<p>Utilize este cmdlet para criar um objeto de regra que adiciona a um passo de sequência de <strong>tarefas Definir Variáveis Dinâmicas</strong> . Para adicionar regras, utilize os cmdlets <a href=\"new-cmtsstepsetdynamicvariable\">New-CMTSStepSetDynamicVariable</a> ou <a href=\"set-cmtsstepsetdynamicvariable\">Set-CMTSStepSetDynamicVariable</a> . Quando a sequência de tarefas executa este passo, avalia as regras e variáveis dinâmicas por ordem. Quando avalia as regras no dispositivo específico, pode definir variáveis de sequência de tarefas com base nessas regras.</p>\n<p>Existem quatro tipos de regras:</p>\n<ul>\n<li>\n              <strong>Computador</strong>: avalie os valores da etiqueta de recurso de hardware, UUID, número de série ou endereço MAC.</li>\n<li>\n              <strong>Localização</strong>: avalie os valores do gateway de rede predefinido.</li>\n<li>\n              <strong>Criar e Modelar</strong>: avalie os valores para a criação e o modelo de um computador.</li>\n<li>\n              <strong>Variável de sequência de tarefas</strong>: adicione uma variável de sequência de tarefas, condição e valor para avaliar.</li>\n</ul>\n<p>Para obter mais informações, veja <a href=\"/mem/configmgr/osd/understand/task-sequence-steps#dynamic-rules-and-variables\">Regras e variáveis dinâmicas</a>.</p>\n<div class=\"NOTE\">\n<p>Observação</p>\n<p>Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo <code>PS XYZ:\\&gt;</code>. Para obter mais informações, veja <a href=\"/powershell/sccm/overview\">Introdução</a>.</p>\n</div>\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":"<p>Este exemplo cria a seguinte regra:</p>\n<p><code>IF _SMSTSInWinPE equals &quot;TRUE&quot; THEN SET OSDDownloadDestinationLocationType = &quot;TSCache&quot;</code></p>\n<p>Em seguida, adiciona esta regra a uma instância existente deste passo numa sequência de tarefas.</p>\n","title":"Exemplo 1: Definir o destino da transferência se estiver no Windows PE"}],"inputs":[{"description":"","name":"<span class=\"no-loc xref\">None</span>\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":"Acerca dos passos de sequência de tarefas – Definir Variáveis Dinâmicas"},{"href":"/mem/configmgr/osd/understand/using-task-sequence-variables","text":"Como utilizar variáveis de sequência de tarefas no Configuration Manager"}],"module":"ConfigurationManager","name":"New-CMTSRule","notes":"","outputs":[{"description":"","name":"<span class=\"no-loc xref\">IResultObject</span>\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"<p>Especifique uma <strong>etiqueta Asset</strong> para o Tipo de regra de <strong>computador</strong> . O valor máximo é de 255 carateres.</p>\n<p>Por exemplo, se definir este valor como <code>123456</code>, adiciona a seguinte regra: <code>IF Asset tag equals &quot;123456&quot; THEN</code></p>\n","name":"AssetTag","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"cf","defaultValue":"None","description":"<p>Solicita a confirmação antes de executar o cmdlet.</p>\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique o <strong>Gateway predefinido</strong> para o tipo de regra <strong>localização</strong> .</p>\n<p>Por exemplo, se definir este valor como <code>192.168.10.1</code>, adiciona a seguinte regra: <code>IF Default gateway equals &quot;192.168.10.1&quot; THEN</code></p>\n","name":"DefaultGateway","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com <strong>ForceWildcardHandling</strong>.</p>\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com <strong>DisableWildcardHandling</strong>.</p>\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique o <strong>endereço MAC</strong> para o Tipo de regra de <strong>computador</strong> .</p>\n<p>Por exemplo, se definir este valor como <code>00:11:22:33:44:55</code>, adiciona a seguinte regra: <code>IF MAC address equals &quot;00:11:22:33:44:55&quot; THEN</code></p>\n","name":"MacAddress","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique o tipo de regra <strong>Criar e Modelo</strong>.<strong></strong> Para definir o outro valor, utilize o parâmetro <strong>Modelo</strong> . A regra avalia verdadeiro quando ambos os valores são verdadeiros.</p>\n<p>Pode utilizar carateres universais:</p>\n<ul>\n<li>\n              <code>*</code>: Múltiplos carateres</li>\n<li>\n              <code>?</code>: caráter único</li>\n</ul>\n<p>Por exemplo, se definir este valor como <code>Surface</code> e o <strong>Modelo</strong> como <code>*</code>, adiciona a seguinte regra: <code>IF Make equals &quot;Surface&quot; AND Model equals &quot;*&quot; THEN</code></p>\n","name":"Make","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique o <strong>Modelo</strong> para o tipo de regra <strong>Criar e Modelo</strong> . Para definir o outro valor, utilize o parâmetro <strong>Make</strong> . A regra avalia verdadeiro quando ambos os valores são verdadeiros.</p>\n<p>Pode utilizar carateres universais:</p>\n<ul>\n<li>\n              <code>*</code>: Múltiplos carateres</li>\n<li>\n              <code>?</code>: caráter único</li>\n</ul>\n<p>Por exemplo, se definir este valor como <code>*</code> e <strong>Make</strong> como <code>Surface</code>, adiciona a seguinte regra: <code>IF Make equals &quot;Surface&quot; AND Model equals &quot;*&quot; THEN</code></p>\n","name":"Model","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique a <strong>Variável</strong> para o tipo de regra <strong>Variável de Sequência de Tarefas</strong> . Requer que também defina os parâmetros <strong>ReferencedVariableOperator</strong> e <strong>ReferencedVariableValue</strong> .</p>\n<p>Este nome de variável pode ser uma variável de sequência de tarefas incorporada ou personalizada que criou. Para obter mais informações, veja <a href=\"/mem/configmgr/osd/understand/using-task-sequence-variables\">Como utilizar variáveis de sequência de tarefas no Configuration Manager</a>.</p>\n<p>Por exemplo, se definir os seguintes valores:</p>\n<ul>\n<li>\n              <strong>ReferencedVariableName</strong>: <code>OSDRegisteredOrgName</code></li>\n<li>\n              <strong>ReferencedVariableOperator</strong>: <code>Equals</code></li>\n<li>\n              <strong>ReferencedVariableValue</strong>: <code>Contoso</code></li>\n</ul>\n<p>Em seguida, adiciona a seguinte regra: <code>IF OSDRegisteredOrgName equals &quot;Contoso&quot; THEN</code></p>\n","name":"ReferencedVariableName","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique a <strong>Condição</strong> para o tipo de regra <strong>Variável de Sequência de Tarefas</strong> . Requer que também defina os parâmetros <strong>ReferencedVariableName</strong> e <strong>ReferencedVariableValue</strong> . Para os operadores disponíveis, veja a lista de valores aceites para este parâmetro.</p>\n<p>Por exemplo, se definir os seguintes valores:</p>\n<ul>\n<li>\n              <strong>ReferencedVariableName</strong>: <code>OSDRegisteredOrgName</code></li>\n<li>\n              <strong>ReferencedVariableOperator</strong>: <code>Equals</code></li>\n<li>\n              <strong>ReferencedVariableValue</strong>: <code>Contoso</code></li>\n</ul>\n<p>Em seguida, adiciona a seguinte regra: <code>IF OSDRegisteredOrgName equals &quot;Contoso&quot; THEN</code></p>\n","name":"ReferencedVariableOperator","parameterValueGroup":"Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike","position":"Named","type":"<span class=\"no-loc xref\">VariableOperatorType</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique o <strong>Valor</strong> para o tipo de regra <strong>Variável de Sequência de Tarefas</strong> . Requer que também defina os parâmetros <strong>ReferencedVariableName</strong> e <strong>ReferencedVariableOperator</strong> .</p>\n<p>Por exemplo, se definir os seguintes valores:</p>\n<ul>\n<li>\n              <strong>ReferencedVariableName</strong>: <code>OSDRegisteredOrgName</code></li>\n<li>\n              <strong>ReferencedVariableOperator</strong>: <code>Equals</code></li>\n<li>\n              <strong>ReferencedVariableValue</strong>: <code>Contoso</code></li>\n</ul>\n<p>Em seguida, adiciona a seguinte regra: <code>IF OSDRegisteredOrgName equals &quot;Contoso&quot; THEN</code></p>\n","name":"ReferencedVariableValue","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique um <strong>Número de série</strong> para o tipo <strong>de regra Computador</strong> .</p>\n<p>Por exemplo, se definir este valor como <code>123456</code>, adiciona a seguinte regra: <code>IF Asset tag equals &quot;123456&quot; THEN</code></p>\n","name":"SerialNumber","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique um <strong>UUID</strong> para o tipo <strong>de regra Computador</strong> .</p>\n<p>Por exemplo, se definir este valor como <code>de5ba380-f692-45e0-bbd3-0e40543b549e</code>, adiciona a seguinte regra: <code>IF UUID equals &quot;de5ba380-f692-45e0-bbd3-0e40543b549e&quot; THEN</code></p>\n","name":"Uuid","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"Variables","defaultValue":"None","description":"<p>Especifique as variáveis de sequência de tarefas existentes ou personalizadas e os valores associados que o passo deve definir quando a regra for avaliada como verdadeira.</p>\n<p>Por exemplo, se definir este valor como <code>@{'OSDDownloadDestinationLocationType' = 'TSCache'}</code>, adiciona a seguinte variável após a <code>THEN</code> da regra: <code>SET OSDDownloadDestinationLocationType = &quot;TSCache&quot;</code></p>\n<p>Para especificar mais do que uma variável na mesma tabela hash, utilize um delimitador de ponto e vírgula (<code>;</code>). Por exemplo: <code>@{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}</code></p>\n","isRequired":true,"name":"Variable","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Hashtable</span>\n"},{"aliases":"wi","defaultValue":"None","description":"<p>Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.</p>\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"}],"schema":"PowershellCmdlet","summary":"<p>Crie uma regra para adicionar a um passo de sequência de <strong>tarefas Definir Variáveis Dinâmicas</strong> .</p>\n","syntaxes":["New-CMTSRule -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n [<CommonParameters>]","New-CMTSRule [-AssetTag <String>] [-MacAddress <String>] [-SerialNumber <String>] [-Uuid <String>]\n -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n [<CommonParameters>]","New-CMTSRule [-DefaultGateway <String>] -Variable <Hashtable> [-DisableWildcardHandling]\n [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]","New-CMTSRule [-Make <String>] [-Model <String>] -Variable <Hashtable> [-DisableWildcardHandling]\n [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]","New-CMTSRule [-ReferencedVariableName <String>] [-ReferencedVariableOperator <VariableOperatorType>]\n [-ReferencedVariableValue <String>] -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling]\n [-WhatIf] [-Confirm] [<CommonParameters>]"],"uid":"ConfigurationManager.New-CMTSRule","hideEdit":true,"ms.translationtype":"MT","ms.contentlocale":"pt-br","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":"<p>Crie uma regra para adicionar a um passo de sequência de <strong>tarefas Definir Variáveis Dinâmicas</strong> .</p>\n","uid":"ConfigurationManager.New-CMTSRule"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmtsrule?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmtsrule?view=sccm-ps"},"pageMetadata":"<meta name=\"description\" content=\"<p>Utilize este cmdlet para criar um objeto de regra que adiciona a um passo de sequência de <strong>tarefas Definir Variáveis Dinâmicas</strong> . Para adicionar regras, utilize os cmdlets <a href=&quot;new-cmtsstepsetdynamicvariable&quot;>New-CMTSStepSetDynamicVariable</a> ou <a href=&quot;set-cmtsstepsetdynamicvariable&quot;>Set-CMTSStepSetDynamicVariable</a> . Quando a sequência de tarefas executa este passo, avalia as regras e variáveis dinâmicas por ordem. Quando avalia as regras no dispositivo específico, pode definir variáveis de sequência de tarefas com base nessas regras.</p>\n<p>Existem quatro tipos de regras:</p>\n<ul>\n<li>\n              <strong>Computador</strong>: avalie os valores da etiqueta de recurso de hardware, UUID, número de série ou endereço MAC.</li>\n<li>\n              <strong>Localização</strong>: avalie os valores do gateway de rede predefinido.</li>\n<li>\n              <strong>Criar e Modelar</strong>: avalie os valores para a criação e o modelo de um computador.</li>\n<li>\n              <strong>Variável de sequência de tarefas</strong>: adicione uma variável de sequência de tarefas, condição e valor para avaliar.</li>\n</ul>\n<p>Para obter mais informações, veja <a href=&quot;/mem/configmgr/osd/understand/task-sequence-steps#dynamic-rules-and-variables&quot;>Regras e variáveis dinâmicas</a>.</p>\n<div class=&quot;NOTE&quot;>\n<p>Observação</p>\n<p>Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo <code>PS XYZ:\\&amp;gt;</code>. Para obter mais informações, veja <a href=&quot;/powershell/sccm/overview&quot;>Introdução</a>.</p>\n</div>\n\" />\r\n<meta name=\"hideEdit\" content=\"true\" />\r\n<meta name=\"loc_file_id\" content=\"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/New-CMTSRule.md\" />\r\n<meta name=\"loc_source_id\" content=\"Github-72476255#live\" />\r\n<meta name=\"loc_version\" content=\"2024-08-21T21:18:36.7205003Z\" />\r\n<meta name=\"module\" content=\"ConfigurationManager\" />\r\n<meta name=\"ms.contentlocale\" content=\"pt-br\" />\r\n<meta name=\"ms.translationtype\" content=\"MT\" />\r\n<meta name=\"name\" content=\"New-CMTSRule\" />\r\n<meta name=\"notes\" content=\"\" />\r\n<meta name=\"schema\" content=\"PowershellCmdlet\" />\r\n<meta name=\"summary\" content=\"<p>Crie uma regra para adicionar a um passo de sequência de <strong>tarefas Definir Variáveis Dinâmicas</strong> .</p>\n\" />\r\n<meta name=\"syntaxes\" content=\"New-CMTSRule -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"New-CMTSRule [-AssetTag <String>] [-MacAddress <String>] [-SerialNumber <String>] [-Uuid <String>]\n -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"New-CMTSRule [-DefaultGateway <String>] -Variable <Hashtable> [-DisableWildcardHandling]\n [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"New-CMTSRule [-Make <String>] [-Model <String>] -Variable <Hashtable> [-DisableWildcardHandling]\n [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"New-CMTSRule [-ReferencedVariableName <String>] [-ReferencedVariableOperator <VariableOperatorType>]\n [-ReferencedVariableValue <String>] -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling]\n [-WhatIf] [-Confirm] [<CommonParameters>]\" />\r\n<meta name=\"uid\" content=\"ConfigurationManager.New-CMTSRule\" />\r\n","themesRelativePathToOutputRoot":"_themes/"}