Get-CMDeviceCollection

Obtén una o varias colecciones de dispositivos.

Syntax

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 más colecciones de dispositivos. Para obtener colecciones de usuarios o dispositivos, use el cmdlet Get-CMCollection. Para obtener más información acerca de las colecciones, vea Introduction to Collections in Configuration Manager.

Nota

Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\> . Para obtener más información, vea getting started.

Ejemplos

Ejemplo 1: Obtener una colección de dispositivos mediante un identificador

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

Get-CMDeviceCollection -CollectionId "SM00001"

Ejemplo 2: Obtener todas las colecciones 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.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 entre corchetes, por ejemplo, {537e6303-69eb-4104-bf7b-7baf43ce2352} .

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPointGroupName

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifica el identificador de la colección de dispositivos que quieres obtener. Este valor es la propiedad CollectionID, por ejemplo, XYZ00012 o SMS00001 .

Type:String
Aliases:CollectionId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica el nombre de la colección de dispositivos que quieres obtener.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

Entradas

Ninguno

Salidas

System.Object

Notas

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