{"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":"21/08/2026","updated_at_date_time":"2026-08-21T08:55:41.5540025Z"},"_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","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":"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-21 08:55 AM","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 uma etapa de sequência de tarefas <strong>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 uma etapa de sequência de tarefas <strong>Definir Variáveis Dinâmicas</strong> .</p>\n","uid":"ConfigurationManager.New-CMTSRule"}},"description":"<p>Use este cmdlet para criar um objeto de regra que você adiciona a uma etapa de sequência de tarefas <strong>Definir Variáveis Dinâmicas</strong> . Para adicionar regras, use os cmdlets <a href=\"new-cmtsstepsetdynamicvariable\">New-CMTSStepSetDynamicVariable</a> ou <a href=\"set-cmtsstepsetdynamicvariable\">Set-CMTSStepSetDynamicVariable</a> . Quando a sequência de tarefas executa esta etapa, ela avalia as regras dinâmicas e as variáveis em ordem. Ao avaliar as regras no dispositivo específico, ele 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 para marca de ativo de hardware, UUID, número de série ou endereço MAC.</li>\n<li>\n              <strong>Local</strong>: avalie os valores do gateway de rede padrão.</li>\n<li>\n              <strong>Make and Model</strong>: Avalie os valores da marca e do 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, uma condição e um valor para avaliar.</li>\n</ul>\n<p>Para obter mais informações, consulte <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 na unidade do site do Configuration Manager, por exemplo<code>PS XYZ:\\&gt;</code>. Para obter mais informações, consulte <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 essa regra a uma instância existente dessa etapa em uma sequência de tarefas.</p>\n","title":"Exemplo 1: Definir o destino de download 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":"Sobre etapas de sequência de tarefas - Definir Variáveis Dinâmicas"},{"href":"/mem/configmgr/osd/understand/using-task-sequence-variables","text":"Como usar 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>marca de ativo</strong> para o tipo <strong>de regra de computador</strong> . O valor máximo é de 255 caracteres.</p>\n<p>Por exemplo, se você definir esse valor como <code>123456</code>, ele adicionará 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 Padrão</strong> para o tipo de regra <strong>Local</strong> .</p>\n<p>Por exemplo, se você definir esse valor como <code>192.168.10.1</code>, ele adicionará 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>Esse parâmetro trata caracteres curinga como valores de caracteres literais. Você 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>Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você 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 <strong>de computador</strong> .</p>\n<p>Por exemplo, se você definir esse valor como <code>00:11:22:33:44:55</code>, ele adicionará 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 a <strong>marca</strong> para o tipo <strong>de regra marca e modelo</strong> . Para definir o outro valor, use o parâmetro <strong>Modelo</strong> . A regra é avaliada como verdadeira quando ambos os valores são verdadeiros.</p>\n<p>Você pode usar caracteres curinga:</p>\n<ul>\n<li>\n              <code>*</code>: vários caracteres</li>\n<li>\n              <code>?</code>: Caractere único</li>\n</ul>\n<p>Por exemplo, se você definir esse valor como <code>Surface</code> e o <strong>Modelo</strong> como <code>*</code>, ele adicionará 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 <strong>de regra Criar e Modelo</strong> . Para definir o outro valor, use o parâmetro <strong>Make</strong> . A regra é avaliada como verdadeira quando ambos os valores são verdadeiros.</p>\n<p>Você pode usar caracteres curinga:</p>\n<ul>\n<li>\n              <code>*</code>: vários caracteres</li>\n<li>\n              <code>?</code>: Caractere único</li>\n</ul>\n<p>Por exemplo, se você definir esse valor como <code>*</code> e o <strong>Make</strong> to <code>Surface</code>, ele adicionará 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 <strong>de regra variável de sequência de tarefas</strong> . Ele requer que você também defina os parâmetros <strong>ReferencedVariableOperator</strong> e <strong>ReferencedVariableValue</strong> .</p>\n<p>Esse nome de variável pode ser uma variável de sequência de tarefas interna ou uma variável personalizada que você criou. Para obter mais informações, consulte <a href=\"/mem/configmgr/osd/understand/using-task-sequence-variables\">Como usar variáveis de sequência de tarefas no Configuration Manager</a>.</p>\n<p>Por exemplo, se você 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, acrescenta 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> . Ele requer que você também defina os parâmetros <strong>ReferencedVariableName</strong> e <strong>ReferencedVariableValue</strong> . Para os operadores disponíveis, consulte a lista de valores aceitos para este parâmetro.</p>\n<p>Por exemplo, se você 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, acrescenta 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> do tipo de regra <strong>Variável de Sequência de Tarefas</strong> . Ele requer que você também defina os parâmetros <strong>ReferencedVariableName</strong> e <strong>ReferencedVariableOperator</strong> .</p>\n<p>Por exemplo, se você 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, acrescenta 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 de regra <strong>de computador</strong> .</p>\n<p>Por exemplo, se você definir esse valor como <code>123456</code>, ele adicionará 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 de computador</strong> .</p>\n<p>Por exemplo, se você definir esse valor como <code>de5ba380-f692-45e0-bbd3-0e40543b549e</code>, ele adicionará 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 a etapa deve definir quando a regra for avaliada como verdadeira.</p>\n<p>Por exemplo, se você definir esse valor como <code>@{'OSDDownloadDestinationLocationType' = 'TSCache'}</code>, ele adicionará a seguinte variável após a <code>THEN</code> regra: <code>SET OSDDownloadDestinationLocationType = &quot;TSCache&quot;</code></p>\n<p>Para especificar mais de uma variável na mesma tabela de hash, use 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 uma etapa de sequência de tarefas <strong>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 uma etapa de sequência de tarefas <strong>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>Use este cmdlet para criar um objeto de regra que você adiciona a uma etapa de sequência de tarefas <strong>Definir Variáveis Dinâmicas</strong> . Para adicionar regras, use 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 esta etapa, ela avalia as regras dinâmicas e as variáveis em ordem. Ao avaliar as regras no dispositivo específico, ele 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 para marca de ativo de hardware, UUID, número de série ou endereço MAC.</li>\n<li>\n              <strong>Local</strong>: avalie os valores do gateway de rede padrão.</li>\n<li>\n              <strong>Make and Model</strong>: Avalie os valores da marca e do 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, uma condição e um valor para avaliar.</li>\n</ul>\n<p>Para obter mais informações, consulte <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 na unidade do site do Configuration Manager, por exemplo<code>PS XYZ:\\&amp;gt;</code>. Para obter mais informações, consulte <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 uma etapa de sequência de tarefas <strong>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/"}