Configure um dispositivo ou coleção de usuários.
\n","uid":"ConfigurationManager.Set-CMCollection"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Set-CMCollection":{"href":"set-cmcollection","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Set-CMCollection","schemaType":"PowershellCmdlet","summary":"Configure um dispositivo ou coleção de usuários.
\n","uid":"ConfigurationManager.Set-CMCollection"}},"description":"Use este cmdlet para configurar um conjunto de dispositivos ou de usuários.
\nA coleção de limitação determina quais recursos podem ser membros da coleção.\nPor exemplo, quando você usa a coleção Todos os Sistemas como a coleção limitante, a nova coleção pode incluir qualquer dispositivo na hierarquia do Configuration Manager.
\nAdicione 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\nNão é possível configurar coleções padrão. Qualquer coleção direcionada deve ter uma ID que comece com o código do site, não SMS.
Para 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.
O primeiro comando obtém o objeto de coleção chamado testUser e o armazena na variável $userCollection .
\nO segundo comando atualiza o nome da coleção.
\n","title":"Exemplo 1: Renomear uma coleção"}],"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":"new-cmcollection","text":"New-CMCollection"},{"href":"remove-cmcollection","text":"Remove-CMCollection"},{"href":"set-cmcollection","text":"Set-CMCollection"},{"href":"set-cmdevicecollectionvariable","text":"Set-CMDeviceCollectionVariable"},{"href":"get-cmdevicecollection","text":"Get-CMDeviceCollection"},{"href":"get-cmusercollection","text":"Get-CMUserCollection"},{"href":"/mem/configmgr/core/clients/manage/collections/create-collections","text":"Como criar coleções no Configuration Manager"}],"module":"ConfigurationManager","name":"Set-CMCollection","notes":"","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"Especifique a ID da coleção a ser configurada. Esse valor é a propriedade CollectionID , por exemplo, XYZ00012. Você não pode configurar coleções padrão, portanto, esse valor começa com o código do site, não SMS.
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":"Collection","defaultValue":"None","description":"Especifique um objeto de coleção a ser configurado. 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":"","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","name":"LimitingCollection","parameterValueGroup":"","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","name":"LimitingCollectionName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique o nome de uma coleção a ser configurada.
\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique um novo nome para a coleção. Use esse parâmetro para renomeá-lo.
\n","name":"NewName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"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.
\n","name":"PassThru","parameterValueGroup":"","position":"Named","type":"SwitchParameter\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 configurar variáveis em uma coleção de dispositivos, use o cmdlet Set-CMDeviceCollectionVariable .
\nPara exibir a prioridade da variável atual, use o cmdlet Get-CMCollectionSetting .
\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":"Configure um dispositivo ou coleção de usuários.
\n","syntaxes":["Set-CMCollection [-CommentConfigure um dispositivo ou coleção de usuários.
\n","uid":"ConfigurationManager.Set-CMCollection"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/set-cmcollection?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/set-cmcollection?view=sccm-ps"},"pageMetadata":"Use este cmdlet para configurar um conjunto de dispositivos ou de usuários.\nA coleção de limitação determina quais recursos podem ser membros da coleção.\nPor exemplo, quando você usa a coleção Todos os Sistemas como a coleção limitante, a nova coleção pode incluir qualquer dispositivo na hierarquia do Configuration Manager.
\nAdicione 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\nNão é possível configurar coleções padrão. Qualquer coleção direcionada deve ter uma ID que comece com o código do site, não SMS.
Para 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.