Crie uma coleção de dispositivos ou de usuários.
\n","uid":"ConfigurationManager.New-CMCollection"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMCollection":{"href":"new-cmcollection","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMCollection","schemaType":"PowershellCmdlet","summary":"Crie uma coleção de dispositivos ou de usuários.
\n","uid":"ConfigurationManager.New-CMCollection"}},"description":"Use este cmdlet para criar uma coleção de dispositivos ou usuários.
\nA coleção limitante determina quais recursos podem ser membros da coleção que você cria.\nPor exemplo, quando você usa a coleção Todos os Sistemas como a coleção limitante, já que é uma coleção de dispositivos, a nova coleção de dispositivos pode incluir qualquer dispositivo na hierarquia do Configuration Manager.
\nPara definir o escopo do tipo de coleção que você cria, você também pode usar os cmdlets New-CMDeviceCollection ou New-CMUserCollection .
\nDepois de criar uma coleção, adicione recursos à coleção com regras de associação.\nPara adicionar membros à coleção, use um dos cmdlets para adicionar regras de associação, por exemplo:
\n\nPara obter mais informações, consulte Como criar coleções no Configuration Manager.
\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.
Esse comando cria uma coleção de usuários chamada testUser que define a coleção Todos os Usuários como a coleção limitante.
\n","title":"Exemplo 1: Criar uma coleção de usuários"},{"code":"Get-CMCollection -Name \"All Users\" | New-CMCollection -Name \"testUser\" -CollectionType \"User\"","description":"","summary":"Primeiro, esse comando usa Get-CMCollection para obter o objeto de coleção Todos os Usuários . Em seguida, ele usa o operador de pipeline para passar o objeto para o cmdlet New-CMCollection , que cria uma coleção chamada testUser. A coleção limitante para a nova coleção testUser é a coleção Todos os Usuários .
\n","title":"Exemplo 2: Definir a coleção de limitação por meio do pipeline"}],"inputs":[{"description":"","name":"Microsoft.ConfigurationManagement.ManagementProvider.IResultObject\n"}],"links":[{"href":"copy-cmcollection","text":"Copy-CMCollection"},{"href":"export-cmcollection","text":"Export-CMCollection"},{"href":"get-cmcollection","text":"Get-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":"remove-cmcollection","text":"Remove-CMCollection"},{"href":"set-cmcollection","text":"Set-CMCollection"},{"href":"new-cmdevicecollectionvariable","text":"New-CMDeviceCollectionVariable"},{"href":"new-cmdevicecollection","text":"New-CMDeviceCollection"},{"href":"new-cmusercollection","text":"New-CMUserCollection"},{"href":"/mem/configmgr/core/clients/manage/collections/create-collections","text":"Como criar coleções no Configuration Manager"}],"module":"ConfigurationManager","name":"New-CMCollection","notes":"Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte SMS_Collection classe WMI do servidor.
\n","outputs":[{"description":"","name":"IResultObject\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"Especifique o tipo de coleção a ser criada. Esse parâmetro é funcionalmente o mesmo que usar os cmdlets New-CMDeviceCollection ou New-CMUserCollection .
\n","isRequired":true,"name":"CollectionType","parameterValueGroup":"User, Device","position":"Named","type":"CollectionType\n"},{"aliases":"","defaultValue":"None","description":"Especifique um comentário opcional para descrever e identificar esta coleção.
\n","name":"Comment","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"cf","defaultValue":"False","description":"Solicita a confirmação antes de executar o cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro trata caracteres curinga como valores de caracteres literais. Você não pode combiná-lo com ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"LimitingCollection","defaultValue":"None","description":"Especifique um objeto para a coleção limitante. Para obter esse objeto, use os cmdlets Get-CMCollection, Get-CMDeviceCollection ou Get-CMUserCollection .
\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"IResultObject\n"},{"aliases":"LimitToCollectionId","defaultValue":"None","description":"Especifique a ID da coleção limitante. Esse valor é a propriedade CollectionID , por exemplo, XYZ00012 ou SMS00001.
Especifique o nome da coleção limitante.
\n","isRequired":true,"name":"LimitingCollectionName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique o nome da nova coleção.
\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Se você definir o parâmetro RefreshType como ou PeriodicBoth, use esse parâmetro para definir a agenda. Especifique um objeto de agendamento para quando o site executar uma atualização completa da associação da coleção. Para obter esse objeto, use o cmdlet New-CMSchedule .
Especifique como a associação à coleção é atualizada:
\nManual(1): um administrador dispara manualmente uma atualização de associação no console do Configuration Manager ou com o cmdlet Invoke-CMCollectionUpdate.Periodic (2): O site faz uma atualização completa em uma programação. Ele não usa atualizações incrementais. Se você não especificar um tipo, esse valor será o padrão.Continuous (4): O site avalia periodicamente novos recursos e, em seguida, adiciona novos membros. Esse tipo também é conhecido como atualização incremental. Ele não faz uma atualização completa em um agendamento.Both (6): uma combinação de ambos Periodic e Continuous, com atualizações incrementais e uma atualização completa em um cronograma.Se você especificar um Periodic ou Both, use o parâmetro RefreshSchedule para definir a agenda.
Observação
\nO None valor (0) é funcionalmente o mesmo que Manual.
Especifique um valor inteiro de 1 a 9 para a prioridade das variáveis de coleção de dispositivos. \n 1 é a prioridade mais baixa e 9 é a mais alta.
Para criar variáveis em uma coleção de dispositivos, use o cmdlet New-CMDeviceCollectionVariable .
\n","name":"VariablePriority","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"wi","defaultValue":"False","description":"Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"Crie uma coleção de dispositivos ou de usuários.
\n","syntaxes":["New-CMCollection -CollectionTypeCrie uma coleção de dispositivos ou de usuários.
\n","uid":"ConfigurationManager.New-CMCollection"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmcollection?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmcollection?view=sccm-ps"},"pageMetadata":"Use este cmdlet para criar uma coleção de dispositivos ou usuários.\nA coleção limitante determina quais recursos podem ser membros da coleção que você cria.\nPor exemplo, quando você usa a coleção Todos os Sistemas como a coleção limitante, já que é uma coleção de dispositivos, a nova coleção de dispositivos pode incluir qualquer dispositivo na hierarquia do Configuration Manager.
\nPara definir o escopo do tipo de coleção que você cria, você também pode usar os cmdlets New-CMDeviceCollection ou New-CMUserCollection .
\nDepois de criar uma coleção, adicione recursos à coleção com regras de associação.\nPara adicionar membros à coleção, use um dos cmdlets para adicionar regras de associação, por exemplo:
\n\nPara obter mais informações, consulte Como criar coleções no Configuration Manager.
\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.