{"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":"Jonathan Gao","id":"2213767","name":"mumian","profile_url":"https://github.com/mumian"},{"display_name":"sankethka","id":"16908144","name":"sankethka","profile_url":"https://github.com/sankethka"}],"update_at":"01/09/2026","updated_at_date_time":"2026-09-01T11:38:41.6382911Z"},"_path":"module/configurationmanager/get-cmcollection.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/get-cmcollection?view=sccm-ps","content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell-ref/blob/main/sccm-ps/ConfigurationManager/Get-CMCollection.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":"4203a6563bd2461e666e2d652af52c458ba89ef4","gitcommit":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/4203a6563bd2461e666e2d652af52c458ba89ef4/sccm-ps/ConfigurationManager/Get-CMCollection.md","github_contributors":["aczechowski","damabe","mumian","sankethka"],"locale":"pt-br","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"12/29/2021","ms.service":"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/Get-CMCollection.md","original_content_git_url_template":"{repo}/blob/{branch}/sccm-ps/ConfigurationManager/Get-CMCollection.md","PlatyPS schema version":"2.0.0","products":["https://authoring-docs-microsoft.poolparty.biz/devrel/f1499c3b-793f-48c3-a9ce-20285bcc6541"],"site_name":"Docs","title":"Get-CMCollection","titleSuffix":"Configuration Manager","uhfHeaderId":"MSDocsHeader-Powershell","updated_at":"2026-09-01 11:38 AM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/get-cmcollection","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Get-CMCollection","schemaType":"PowershellCmdlet","summary":"<p>Obter um dispositivo ou objeto de coleção de usuário.</p>\n","uid":"ConfigurationManager.Get-CMCollection"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Get-CMCollection":{"href":"get-cmcollection","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Get-CMCollection","schemaType":"PowershellCmdlet","summary":"<p>Obter um dispositivo ou objeto de coleção de usuário.</p>\n","uid":"ConfigurationManager.Get-CMCollection"}},"description":"<p>Use este cmdlet para obter um objeto de coleção de dispositivo ou usuário.</p>\n<p>As coleções ajudam a organizar recursos em unidades gerenciáveis. Você pode criar coleções para atender às suas necessidades de gerenciamento de clientes e executar operações em vários recursos ao mesmo tempo. A maioria das tarefas de gerenciamento depende ou exige o uso de uma ou mais coleções.</p>\n<p>Para definir o escopo do tipo de coleção obtida, use os cmdlets <a href=\"get-cmdevicecollection\">Get-CMDeviceCollection</a> ou <a href=\"get-cmusercollection\">Get-CMUserCollection</a> .</p>\n<p>Se você não especificar uma coleção por nome, ID ou objeto, este cmdlet retornará todas as coleções.</p>\n<p>Para obter mais informações, consulte <a href=\"/mem/configmgr/core/clients/manage/collections/introduction-to-collections\">Introdução às 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":"Get-CMCollection -Name \"testUser\"","description":"","summary":"<p>Esse comando obtém a coleção chamada <strong>testUser</strong>.</p>\n","title":"Exemplo 1: obter uma coleção por nome"},{"code":"Get-CMDistributionPointGroup -Name \"dpg1\" | Get-CMCollection","description":"<p>Quando você distribui conteúdo para essas coleções, o site o distribui automaticamente para todos os membros atuais desse grupo de pontos de distribuição. Para obter mais informações, consulte <a href=\"/mem/configmgr/core/servers/deploy/configure/install-and-configure-distribution-points#bkmk_manage\">Gerenciar grupos de pontos de distribuição</a>.</p>\n","summary":"<p>Esse comando obtém o objeto do grupo de pontos de distribuição chamado <strong>dpg1</strong> e usa o operador de pipeline para passar o objeto para <strong>Get-CMCollection</strong>, que obtém as coleções associadas ao grupo de pontos de distribuição.</p>\n","title":"Exemplo 2: Obter uma coleção para um grupo de pontos de distribuição"}],"inputs":[{"description":"","name":"<span class=\"no-loc xref\">Microsoft.ConfigurationManagement.ManagementProvider.IResultObject</span>\n"}],"links":[{"href":"copy-cmcollection","text":"Copy-CMCollection"},{"href":"export-cmcollection","text":"Export-CMCollection"},{"href":"get-cmcollectionmember","text":"Get-CMCollectionMember"},{"href":"get-cmcollectionsetting","text":"Get-CMCollectionSetting"},{"href":"import-cmcollection","text":"Import-CMCollection"},{"href":"invoke-cmcollectionupdate","text":"Invoke-CMCollectionUpdate"},{"href":"new-cmcollection","text":"New-CMCollection"},{"href":"remove-cmcollection","text":"Remove-CMCollection"},{"href":"set-cmcollection","text":"Set-CMCollection"},{"href":"get-cmdevicecollection","text":"Get-CMDeviceCollection"},{"href":"get-cmusercollection","text":"Get-CMUserCollection"},{"href":"/mem/configmgr/core/clients/manage/collections/introduction-to-collections","text":"Introdução às coleções no Configuration Manager"}],"module":"ConfigurationManager","name":"Get-CMCollection","notes":"<p>Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte <a href=\"/mem/configmgr/develop/reference/core/clients/collections/sms_collection-server-wmi-class\">SMS_Collection classe WMI do servidor</a>.</p>\n","outputs":[{"description":"","name":"<span class=\"no-loc xref\">IResultObject[]</span>\n"},{"description":"","name":"<span class=\"no-loc xref\">IResultObject</span>\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"<p>Filtre o tipo de coleção a ser obtida. Esse parâmetro é funcionalmente o mesmo que usar os cmdlets <a href=\"get-cmdevicecollection\">Get-CMDeviceCollection</a> ou <a href=\"get-cmusercollection\">Get-CMUserCollection</a> .</p>\n","name":"CollectionType","parameterValueGroup":"User, Device","position":"Named","type":"<span class=\"no-loc xref\">CollectionType</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>Especifique um objeto de grupo de ponto de distribuição associado a essa coleção. Para obter esse objeto, use o cmdlet <a href=\"get-cmdistributionpointgroup\">Get-CMDistributionPointGroup</a> .</p>\n","isRequired":true,"name":"DistributionPointGroup","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"<span class=\"no-loc xref\">IResultObject</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique o GUID de um grupo de pontos de distribuição associado a essa coleção. Esse valor é a propriedade <strong>GroupID</strong> , que é um GUID padrão entre colchetes, por exemplo, <code>{537e6303-69eb-4104-bf7b-7baf43ce2352}</code>.</p>\n","isRequired":true,"name":"DistributionPointGroupId","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique o nome de um grupo de pontos de distribuição associado a essa coleção.</p>\n","isRequired":true,"name":"DistributionPointGroupName","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</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":"CollectionId","defaultValue":"None","description":"<p>Especifique a ID da coleção a ser obtida. Esse valor é a propriedade <strong>CollectionID</strong> , por exemplo, <code>XYZ00012</code> ou <code>SMS00001</code>.</p>\n","isRequired":true,"name":"Id","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"acceptWildcardCharacters":true,"aliases":"","defaultValue":"None","description":"<p>Especifique o nome da coleção a ser obtida.</p>\n","name":"Name","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"}],"schema":"PowershellCmdlet","summary":"<p>Obter um dispositivo ou objeto de coleção de usuário.</p>\n","syntaxes":["Get-CMCollection [-CollectionType <CollectionType>] [-Name <String>] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [<CommonParameters>]","Get-CMCollection [-CollectionType <CollectionType>] -DistributionPointGroup <IResultObject>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]","Get-CMCollection [-CollectionType <CollectionType>] -DistributionPointGroupId <String>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]","Get-CMCollection [-CollectionType <CollectionType>] -DistributionPointGroupName <String>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]","Get-CMCollection [-CollectionType <CollectionType>] -Id <String> [-DisableWildcardHandling]\n [-ForceWildcardHandling] [<CommonParameters>]"],"uid":"ConfigurationManager.Get-CMCollection","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/Get-CMCollection.md","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/get-cmcollection","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Get-CMCollection","schemaType":"PowershellCmdlet","summary":"<p>Obter um dispositivo ou objeto de coleção de usuário.</p>\n","uid":"ConfigurationManager.Get-CMCollection"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/get-cmcollection?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/get-cmcollection?view=sccm-ps"},"pageMetadata":"<meta name=\"description\" content=\"<p>Use este cmdlet para obter um objeto de coleção de dispositivo ou usuário.</p>\n<p>As coleções ajudam a organizar recursos em unidades gerenciáveis. Você pode criar coleções para atender às suas necessidades de gerenciamento de clientes e executar operações em vários recursos ao mesmo tempo. A maioria das tarefas de gerenciamento depende ou exige o uso de uma ou mais coleções.</p>\n<p>Para definir o escopo do tipo de coleção obtida, use os cmdlets <a href=&quot;get-cmdevicecollection&quot;>Get-CMDeviceCollection</a> ou <a href=&quot;get-cmusercollection&quot;>Get-CMUserCollection</a> .</p>\n<p>Se você não especificar uma coleção por nome, ID ou objeto, este cmdlet retornará todas as coleções.</p>\n<p>Para obter mais informações, consulte <a href=&quot;/mem/configmgr/core/clients/manage/collections/introduction-to-collections&quot;>Introdução às 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/Get-CMCollection.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=\"Get-CMCollection\" />\r\n<meta name=\"notes\" content=\"<p>Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte <a href=&quot;/mem/configmgr/develop/reference/core/clients/collections/sms_collection-server-wmi-class&quot;>SMS_Collection classe WMI do servidor</a>.</p>\n\" />\r\n<meta name=\"schema\" content=\"PowershellCmdlet\" />\r\n<meta name=\"summary\" content=\"<p>Obter um dispositivo ou objeto de coleção de usuário.</p>\n\" />\r\n<meta name=\"syntaxes\" content=\"Get-CMCollection [-CollectionType <CollectionType>] [-Name <String>] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Get-CMCollection [-CollectionType <CollectionType>] -DistributionPointGroup <IResultObject>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Get-CMCollection [-CollectionType <CollectionType>] -DistributionPointGroupId <String>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Get-CMCollection [-CollectionType <CollectionType>] -DistributionPointGroupName <String>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Get-CMCollection [-CollectionType <CollectionType>] -Id <String> [-DisableWildcardHandling]\n [-ForceWildcardHandling] [<CommonParameters>]\" />\r\n<meta name=\"uid\" content=\"ConfigurationManager.Get-CMCollection\" />\r\n","themesRelativePathToOutputRoot":"_themes/"}