{"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"},{"display_name":"Dan Mabee","id":"40476441","name":"damabe","profile_url":"https://github.com/damabe"},{"display_name":"sankethka","id":"16908144","name":"sankethka","profile_url":"https://github.com/sankethka"}],"update_at":"21/08/2026","updated_at_date_time":"2026-08-21T08:55:45.1791659Z"},"_path":"module/configurationmanager/add-cmdevicecollectiondirectmembershiprule.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/add-cmdevicecollectiondirectmembershiprule?view=sccm-ps","content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell-ref/blob/main/sccm-ps/ConfigurationManager/Add-CMDeviceCollectionDirectMembershipRule.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":"cb64faff743ef3d001f913983a4e1164c7cd5047","gitcommit":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/cb64faff743ef3d001f913983a4e1164c7cd5047/sccm-ps/ConfigurationManager/Add-CMDeviceCollectionDirectMembershipRule.md","github_contributors":["aczechowski","damabe","sankethka"],"locale":"pt-br","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"12/28/2021","ms.service":"microsoft-endpoint-configuration-manager","ms.subservice":"other","ms.topic":"reference","open_to_public_contributors":true,"original_content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/live/sccm-ps/ConfigurationManager/Add-CMDeviceCollectionDirectMembershipRule.md","original_content_git_url_template":"{repo}/blob/{branch}/sccm-ps/ConfigurationManager/Add-CMDeviceCollectionDirectMembershipRule.md","PlatyPS schema version":"2.0.0","products":["https://authoring-docs-microsoft.poolparty.biz/devrel/f1499c3b-793f-48c3-a9ce-20285bcc6541"],"site_name":"Docs","title":"Add-CMDeviceCollectionDirectMembershipRule","titleSuffix":"Configuration Manager","uhfHeaderId":"MSDocsHeader-Powershell","updated_at":"2026-08-21 08:55 AM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/add-cmdevicecollectiondirectmembershiprule","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Add-CMDeviceCollectionDirectMembershipRule","schemaType":"PowershellCmdlet","summary":"<p>Adicione uma regra de associação direta a uma coleção de dispositivos.</p>\n","uid":"ConfigurationManager.Add-CMDeviceCollectionDirectMembershipRule"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Add-CMDeviceCollectionDirectMembershipRule":{"href":"add-cmdevicecollectiondirectmembershiprule","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Add-CMDeviceCollectionDirectMembershipRule","schemaType":"PowershellCmdlet","summary":"<p>Adicione uma regra de associação direta a uma coleção de dispositivos.</p>\n","uid":"ConfigurationManager.Add-CMDeviceCollectionDirectMembershipRule"}},"description":"<p>Use este cmdlet para adicionar uma regra de associação direta a uma coleção de dispositivos.\nUma regra de associação <em>direta</em> permite que você escolha explicitamente os membros da coleção de dispositivos.\nVocê não pode adicionar regras de associação a coleções padrão. Qualquer coleção direcionada deve ter uma ID que comece com o código do site, não <code>SMS</code>.\nPara obter mais informações, consulte <a href=\"/mem/configmgr/core/clients/manage/collections/create-collections\">Como criar coleções no Configuration Manager</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":"Add-CMDeviceCollectionDirectMembershipRule -CollectionId \"XYZ00056\" -ResourceId 16777219","description":"","summary":"<p>Esse comando adiciona uma regra de associação direta à coleção de dispositivos com ID <strong>XYZ00056</strong>. Ele adiciona o recurso com <strong>ID 16777219</strong> à coleção.</p>\n","title":"Exemplo 1: Adicionar uma regra de associação direta"},{"code":"Get-CMCollection -Name \"testCollection\" | Add-CMDeviceCollectionDirectMembershipRule -ResourceId 16777219","description":"","summary":"<p>Primeiro, esse comando usa o cmdlet <strong>Get-CMCollection</strong> para obter o objeto de coleção chamado <strong>testCollection</strong>. Em seguida, ele usa o operador de pipeline para passar o objeto para o cmdlet <strong>Add-CMDeviceCollectionDirectMembershipRule</strong> , que adiciona a regra de associação direta ao objeto de coleção de dispositivos. Ele adiciona o dispositivo com <strong>ID 16777219</strong> à coleção.</p>\n","title":"Exemplo 2: adicionar uma regra de associação direta usando o pipeline"}],"inputs":[{"description":"","name":"<span class=\"no-loc xref\">Microsoft.ConfigurationManagement.ManagementProvider.IResultObject</span>\n"}],"links":[{"href":"get-cmdevicecollectiondirectmembershiprule","text":"Get-CMDeviceCollectionDirectMembershipRule"},{"href":"remove-cmdevicecollectiondirectmembershiprule","text":"Remove-CMDeviceCollectionDirectMembershipRule"},{"href":"get-cmcollection","text":"Get-CMCollection"},{"href":"get-cmdevicecollection","text":"Get-CMDeviceCollection"},{"href":"get-cmresource","text":"Get-CMResource"},{"href":"get-cmdevice","text":"Get-CMDevice"},{"href":"add-cmusercollectiondirectmembershiprule","text":"Add-CMUserCollectionDirectMembershipRule"},{"href":"/mem/configmgr/core/clients/manage/collections/create-collections","text":"Como criar coleções no Configuration Manager"}],"module":"ConfigurationManager","name":"Add-CMDeviceCollectionDirectMembershipRule","notes":"","outputs":[{"description":"","name":"<span class=\"no-loc xref\">System.Object</span>\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"<p>Especifique a ID da coleção de dispositivos para adicionar a regra. Esse valor é a propriedade <strong>CollectionID</strong> , por exemplo, <code>XYZ00012</code>. Como você não pode adicionar regras de associação a coleções padrão, essa ID começa com o código do site e não <code>SMS</code>.</p>\n","isRequired":true,"name":"CollectionId","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique o nome da coleção de dispositivos para adicionar a regra.</p>\n","isRequired":true,"name":"CollectionName","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"cf","defaultValue":"False","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>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":"Collection","defaultValue":"None","description":"<p>Especifique um objeto para a coleção de dispositivos para adicionar a regra. Para obter esse objeto, use os cmdlets <a href=\"get-cmcollection\">Get-CMCollection</a> ou <a href=\"get-cmdevicecollection\">Get-CMDeviceCollection</a> .</p>\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"<span class=\"no-loc xref\">IResultObject</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.</p>\n","name":"PassThru","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"Resources","defaultValue":"None","description":"<p>Especifique uma matriz de objetos de recurso a serem adicionados à coleção de dispositivos com essa regra de associação direta. Para obter esse objeto, use o cmdlet <a href=\"get-cmresource\">Get-CMResource</a> ou o cmdlet <a href=\"get-cmdevice\">Get-CMDevice</a> com o <code>-Resource</code> parâmetro.</p>\n","isRequired":true,"name":"Resource","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">IResultObject</span><span>[</span><span>]</span></p>\n"},{"aliases":"ResourceIds","defaultValue":"None","description":"<p>Especifique uma matriz de IDs dos recursos a serem adicionados à coleção de dispositivos com essa regra de associação direta. Esse valor é a propriedade <strong>ResourceID</strong> , por exemplo <code>16777219</code>.</p>\n","isRequired":true,"name":"ResourceId","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">Int32</span><span>[</span><span>]</span></p>\n"},{"aliases":"wi","defaultValue":"False","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>Adicione uma regra de associação direta a uma coleção de dispositivos.</p>\n","syntaxes":["Add-CMDeviceCollectionDirectMembershipRule -CollectionId <String> [-PassThru] -ResourceId <Int32[]>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]","Add-CMDeviceCollectionDirectMembershipRule -CollectionId <String> [-PassThru] -Resource <IResultObject[]>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]","Add-CMDeviceCollectionDirectMembershipRule -CollectionName <String> [-PassThru] -ResourceId <Int32[]>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]","Add-CMDeviceCollectionDirectMembershipRule -CollectionName <String> [-PassThru] -Resource <IResultObject[]>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]","Add-CMDeviceCollectionDirectMembershipRule -InputObject <IResultObject> [-PassThru] -ResourceId <Int32[]>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]","Add-CMDeviceCollectionDirectMembershipRule -InputObject <IResultObject> [-PassThru] -Resource <IResultObject[]>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]"],"uid":"ConfigurationManager.Add-CMDeviceCollectionDirectMembershipRule","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/Add-CMDeviceCollectionDirectMembershipRule.md","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/add-cmdevicecollectiondirectmembershiprule","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Add-CMDeviceCollectionDirectMembershipRule","schemaType":"PowershellCmdlet","summary":"<p>Adicione uma regra de associação direta a uma coleção de dispositivos.</p>\n","uid":"ConfigurationManager.Add-CMDeviceCollectionDirectMembershipRule"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/add-cmdevicecollectiondirectmembershiprule?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/add-cmdevicecollectiondirectmembershiprule?view=sccm-ps"},"pageMetadata":"<meta name=\"description\" content=\"<p>Use este cmdlet para adicionar uma regra de associação direta a uma coleção de dispositivos.\nUma regra de associação <em>direta</em> permite que você escolha explicitamente os membros da coleção de dispositivos.\nVocê não pode adicionar regras de associação a coleções padrão. Qualquer coleção direcionada deve ter uma ID que comece com o código do site, não <code>SMS</code>.\nPara obter mais informações, consulte <a href=&quot;/mem/configmgr/core/clients/manage/collections/create-collections&quot;>Como criar coleções no Configuration Manager</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/Add-CMDeviceCollectionDirectMembershipRule.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=\"Add-CMDeviceCollectionDirectMembershipRule\" />\r\n<meta name=\"notes\" content=\"\" />\r\n<meta name=\"schema\" content=\"PowershellCmdlet\" />\r\n<meta name=\"summary\" content=\"<p>Adicione uma regra de associação direta a uma coleção de dispositivos.</p>\n\" />\r\n<meta name=\"syntaxes\" content=\"Add-CMDeviceCollectionDirectMembershipRule -CollectionId <String> [-PassThru] -ResourceId <Int32[]>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Add-CMDeviceCollectionDirectMembershipRule -CollectionId <String> [-PassThru] -Resource <IResultObject[]>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Add-CMDeviceCollectionDirectMembershipRule -CollectionName <String> [-PassThru] -ResourceId <Int32[]>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Add-CMDeviceCollectionDirectMembershipRule -CollectionName <String> [-PassThru] -Resource <IResultObject[]>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Add-CMDeviceCollectionDirectMembershipRule -InputObject <IResultObject> [-PassThru] -ResourceId <Int32[]>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Add-CMDeviceCollectionDirectMembershipRule -InputObject <IResultObject> [-PassThru] -Resource <IResultObject[]>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]\" />\r\n<meta name=\"uid\" content=\"ConfigurationManager.Add-CMDeviceCollectionDirectMembershipRule\" />\r\n","themesRelativePathToOutputRoot":"_themes/"}