Partager via


Get-CMCollection

Obtenir un objet de regroupement d’appareils ou d’utilisateurs.

Syntaxe

Get-CMCollection
   [-CollectionType <CollectionType>]
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroup <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroupId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroupName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour obtenir un objet de regroupement d’appareils ou d’utilisateurs.

Les collections vous aident à organiser les ressources en unités gérables. Vous pouvez créer des regroupements pour répondre à vos besoins de gestion des clients et effectuer des opérations sur plusieurs ressources à la fois. La plupart des tâches de gestion s’appuient sur ou nécessitent l’utilisation d’un ou plusieurs regroupements.

Pour définir l’étendue du type de collection que vous obtenez, utilisez les applets de commande Get-CMDeviceCollection ou Get-CMUserCollection .

Si vous ne spécifiez pas de collection par nom, ID ou objet, cette applet de commande retourne toutes les collections.

Pour plus d’informations, 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 une collection par nom

Cette commande obtient la collection nommée testUser.

Get-CMCollection -Name "testUser"

Exemple 2 : Obtenir une collection pour un groupe de points de distribution

Cette commande obtient l’objet de groupe de points de distribution nommé dpg1 et utilise l’opérateur de pipeline pour passer l’objet à Get-CMCollection, qui obtient les collections associées au groupe de points de distribution.

Get-CMDistributionPointGroup -Name "dpg1" | Get-CMCollection

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

-CollectionType

Filtrez le type de collection à obtenir. Ce paramètre est fonctionnellement identique à l’utilisation des applets de commande Get-CMDeviceCollection ou Get-CMUserCollection .

Type:CollectionType
Valeurs acceptées:User, Device
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

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

-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:True
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

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

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

-Id

Spécifiez l’ID de la collection à 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 de la collection à 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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject[]

IResultObject

Notes

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