Compartir a través de

Get-CMDeviceCollection

  • Referencia
Módulo:
ConfigurationManager

Obtenga una o más colecciones de dispositivos.

Sintaxis

Get-CMDeviceCollection
   [-Name <String>]
   [<CommonParameters>]
Get-CMDeviceCollection
   -Id <String>
   [<CommonParameters>]
Get-CMDeviceCollection
   -DistributionPointGroupName <String>
   [<CommonParameters>]
Get-CMDeviceCollection
   -DistributionPointGroupId <String>
   [<CommonParameters>]
Get-CMDeviceCollection
   -DistributionPointGroup <IResultObject>
   [<CommonParameters>]

Description

Use este cmdlet para obtener una o varias colecciones de dispositivos. Para obtener colecciones de usuarios o dispositivos, use el cmdlet Get-CMCollection . Para obtener más información sobre las colecciones, consulte Introducción a las 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: Obtención de una colección de dispositivos mediante un identificador

Este comando obtiene la colección de dispositivos predeterminada Todos los sistemas con el identificador SMS00001.

Get-CMDeviceCollection -CollectionId "SM00001"

Ejemplo 2: Obtención de todas las recopilaciones de dispositivos asociadas a un grupo de puntos de distribución

En este ejemplo se obtienen todas las colecciones de dispositivos asociadas al grupo de puntos de distribución denominado dpg1.

Get-CMDeviceCollection -DistributionPointGroupName "dpg1"

Al distribuir contenido a estas colecciones, el sitio se distribuye automáticamente a todos los miembros actuales de este grupo de puntos de distribución. Para obtener más información, vea Administrar grupos de puntos de distribución.

Parámetros

-DistributionPointGroup

Especifique un objeto de grupo de puntos de distribución asociado a esta colección. Para obtener este objeto, use el cmdlet Get-CMDistributionPointGroup .

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

-DistributionPointGroupId

Especifique el GUID de un grupo de puntos de distribución asociado a esta colección. Este valor es la propiedad GroupID , que es un GUID estándar rodeado de corchetes, por ejemplo, {537e6303-69eb-4104-bf7b-7baf43ce2352}.

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

-DistributionPointGroupName

Especifique el nombre de un grupo de puntos de distribución asociado a esta colección.

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

-Id

Especifique el identificador de la colección de dispositivos que se va a obtener. Este valor es la propiedad CollectionID , por ejemplo, XYZ00012 o SMS00001.

Tipo:String
Alias:CollectionId
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 colección de dispositivos que se va a obtener.

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

Entradas

None

Salidas

System.Object

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_Collection clase WMI de servidor.