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.