Partager via


Get-CMDeviceCollection

Obtenir un ou plusieurs regroupements d’appareils.

Syntaxe

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

Utilisez cette applet de commande pour obtenir un ou plusieurs regroupements d’appareils. Pour obtenir des regroupements d’utilisateurs ou d’appareils, utilisez l’applet de commande Get-CMCollection . Pour plus d’informations sur les regroupements, consultez Présentation des regroupements dans Configuration Manager.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Obtenir un regroupement d’appareils à l’aide d’un ID

Cette commande obtient le regroupement d’appareils par défaut Tous les systèmes avec l’ID SMS00001.

Get-CMDeviceCollection -CollectionId "SM00001"

Exemple 2 : Obtenir toutes les collections d’appareils associées à un groupe de points de distribution

Cet exemple obtient toutes les collections d’appareils associées au groupe de points de distribution nommé dpg1.

Get-CMDeviceCollection -DistributionPointGroupName "dpg1"

Lorsque vous distribuez du contenu à ces collections, le site distribue automatiquement à tous les membres actuels de ce groupe de points de distribution. Pour plus d’informations, consultez Gérer les groupes de points de distribution.

Paramètres

-DistributionPointGroup

Spécifiez un objet groupe de points de distribution associé à cette collection. Pour obtenir cet objet, utilisez l’applet de commande Get-CMDistributionPointGroup .

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DistributionPointGroupId

Spécifiez le GUID d’un groupe de points de distribution associé à cette collection. Cette valeur est la propriété GroupID, qui est un GUID standard entouré d’accolades, par exemple . {537e6303-69eb-4104-bf7b-7baf43ce2352}

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DistributionPointGroupName

Spécifiez le nom d’un groupe de points de distribution associé à cette collection.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifiez l’ID du regroupement d’appareils à obtenir. Cette valeur est la propriété CollectionID , par exemple, XYZ00012 ou SMS00001.

Type:String
Alias:CollectionId
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifiez le nom du regroupement d’appareils à obtenir.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

Entrées

None

Sorties

System.Object

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_Collection classe WMI du serveur.