Cree un dispositivo o una colección de usuarios.
\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":"Cree un dispositivo o una colección de usuarios.
\n","uid":"ConfigurationManager.New-CMCollection"}},"description":"Use este cmdlet para crear un dispositivo o una colección de usuarios.
\nLa colección de limitación determina qué recursos pueden ser miembros de la colección que se crea.\nPor ejemplo, cuando se usa la colección Todos los sistemas como recopilación de limitación, ya que es una recopilación de dispositivos, la nueva recopilación de dispositivos puede incluir cualquier dispositivo en la jerarquía de Configuration Manager.
\nPara limitar el tipo de colección que cree, también puede usar los cmdlets New-CMDeviceCollection o New-CMUserCollection .
\nDespués de crear una colección, agregue recursos a la colección con reglas de pertenencia.\nPara agregar miembros a la colección, use uno de los cmdlets para agregar reglas de pertenencia, por ejemplo:
\n\nPara obtener más información, consulte Creación de colecciones en Configuration Manager.
\nNota:
\nEjecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\\>. Para obtener más información, consulte Introducción.
Este comando crea una colección de usuarios denominada testUser que establece la colección Todos los usuarios como colección de limitación.
\n","title":"Ejemplo 1: Creación de una colección de usuarios"},{"code":"Get-CMCollection -Name \"All Users\" | New-CMCollection -Name \"testUser\" -CollectionType \"User\"","description":"","summary":"Este comando usa primero Get-CMCollection para obtener el objeto de colección All Users . A continuación, usa el operador de canalización para pasar el objeto al cmdlet New-CMCollection , que crea una colección denominada testUser. La colección de limitación de la nueva colección testUser es la colección All Users .
\n","title":"Ejemplo 2: Establecimiento de la colección de limitación a través de la canalización"}],"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":"Creación de colecciones en Configuration Manager"}],"module":"ConfigurationManager","name":"New-CMCollection","notes":"Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_Collection clase WMI de servidor.
\n","outputs":[{"description":"","name":"IResultObject\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"Especifique el tipo de colección que se va a crear. Este parámetro es funcionalmente el mismo que el uso de los cmdlets New-CMDeviceCollection o New-CMUserCollection .
\n","isRequired":true,"name":"CollectionType","parameterValueGroup":"User, Device","position":"Named","type":"CollectionType\n"},{"aliases":"","defaultValue":"None","description":"Especifique un comentario opcional para describir e identificar esta colección.
\n","name":"Comment","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"cf","defaultValue":"False","description":"Solicitará confirmación antes de ejecutar el cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"LimitingCollection","defaultValue":"None","description":"Especifique un objeto para la colección de limitación. Para obtener este objeto, use los cmdlets Get-CMCollection, Get-CMDeviceCollection o Get-CMUserCollection .
\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"IResultObject\n"},{"aliases":"LimitToCollectionId","defaultValue":"None","description":"Especifique el identificador de la colección de limitación. Este valor es la propiedad CollectionID , por ejemplo, XYZ00012 o SMS00001.
Especifique el nombre de la colección de límites.
\n","isRequired":true,"name":"LimitingCollectionName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique el nombre de la nueva colección.
\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Si establece el parámetro RefreshType en Periodic o Both, use este parámetro para establecer la programación. Especifique un objeto de programación para cuando el sitio ejecute una actualización completa de la pertenencia a la colección. Para obtener este objeto, use el cmdlet New-CMSchedule .
Especifique cómo se actualiza la pertenencia a la colección:
\nManual (1): un administrador desencadena manualmente una actualización de pertenencia en la consola de Configuration Manager o con el cmdlet Invoke-CMCollectionUpdate .Periodic (2): El sitio realiza una actualización completa según una programación. No usa actualizaciones incrementales. Si no especifica un tipo, este valor es el predeterminado.Continuous (4): el sitio evalúa periódicamente los nuevos recursos y, a continuación, agrega nuevos miembros. Este tipo también se conoce como actualización incremental. No realiza una actualización completa según una programación.Both (6): combinación de Periodic y Continuous, con actualizaciones incrementales y una actualización completa según una programación.Si especifica o PeriodicBoth, use el parámetro RefreshSchedule para establecer la programación.
Nota:
\nEl None valor (0) es funcionalmente el mismo Manualque .
Especifique un valor entero de 1 a 9 para la prioridad de las variables de recopilación de dispositivos. \n 1 es la prioridad más baja y 9 es la más alta.
Para crear variables en una colección de dispositivos, use el cmdlet New-CMDeviceCollectionVariable .
\n","name":"VariablePriority","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"wi","defaultValue":"False","description":"Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"Cree un dispositivo o una colección de usuarios.
\n","syntaxes":["New-CMCollection -CollectionTypeCree un dispositivo o una colección de usuarios.
\n","uid":"ConfigurationManager.New-CMCollection"}],"canonical_url":"https://learn.microsoft.com/es-es/powershell/module/configurationmanager/new-cmcollection?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/es-es/powershell/module/configurationmanager/new-cmcollection?view=sccm-ps"},"pageMetadata":"Use este cmdlet para crear un dispositivo o una colección de usuarios.\nLa colección de limitación determina qué recursos pueden ser miembros de la colección que se crea.\nPor ejemplo, cuando se usa la colección Todos los sistemas como recopilación de limitación, ya que es una recopilación de dispositivos, la nueva recopilación de dispositivos puede incluir cualquier dispositivo en la jerarquía de Configuration Manager.
\nPara limitar el tipo de colección que cree, también puede usar los cmdlets New-CMDeviceCollection o New-CMUserCollection .
\nDespués de crear una colección, agregue recursos a la colección con reglas de pertenencia.\nPara agregar miembros a la colección, use uno de los cmdlets para agregar reglas de pertenencia, por ejemplo:
\n\nPara obtener más información, consulte Creación de colecciones en Configuration Manager.
\nNota:
\nEjecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\\>. Para obtener más información, consulte Introducción.