Compartir a través de

New-CMDeviceCollection

  • Referencia
Módulo:
ConfigurationManager

Cree una colección de dispositivos.

Sintaxis

New-CMDeviceCollection
   [-Comment <String>]
   -LimitingCollectionName <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMDeviceCollection
   [-Comment <String>]
   -InputObject <IResultObject>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMDeviceCollection
   [-Comment <String>]
   -LimitingCollectionId <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para crear una colección de dispositivos basada en una colección de limitación específica. La recopilación de limitación determina qué dispositivos pueden ser miembros de la colección de dispositivos que se crea. Por ejemplo, cuando se usa la colección All Systems como recopilación de limitación, la nueva colección puede incluir cualquier dispositivo en la jerarquía de Configuration Manager.

Después, puede agregar dispositivos a la colección con reglas de pertenencia. Para agregar miembros a la colección de dispositivos, use uno de los siguientes cmdlets de regla de pertenencia:

Para obtener más información, consulte Creación de colecciones en Configuration Manager.

Nota:

Ejecute 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.

Ejemplos

Ejemplo 1: Creación de una colección de dispositivos

Este comando crea una colección para todos los equipos que ejecutan Windows 11. El parámetro LimitingCollectionName especifica que cualquier dispositivo de la colección All Systems puede ser miembro de la nueva colección.

New-CMDeviceCollection -Name "Windows 11" -LimitingCollectionName "All Systems"

Parámetros

-Comment

Especifique un comentario opcional para describir e identificar esta colección.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifique un objeto para la colección de limitación. Para obtener este objeto, use los cmdlets Get-CMCollection o Get-CMDeviceCollection .

Tipo:IResultObject
Alias:LimitingCollection
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-LimitingCollectionId

Especifique el identificador de la colección de limitación. Este valor es la propiedad CollectionID , por ejemplo, XYZ00012 o SMS00001.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LimitingCollectionName

Especifique el nombre de la colección de límites.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifique el nombre de la nueva colección de dispositivos.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RefreshSchedule

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 .

Tipo:IResultObject
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RefreshType

Especifique cómo se actualiza la pertenencia a la colección:

  • Manual (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:

El None valor (0) es funcionalmente el mismo Manualque .

Tipo:CollectionRefreshType
Valores aceptados:None, Manual, Periodic, Continuous, Both
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object