Get-CMCollection

  • Référence
Module:
ConfigurationManager

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

Syntax

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 collections dans Configuration Manager.

Remarque

Exécutez Configuration Manager applets de commande à 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
Accepted values:User, Device
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPointGroupName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Spécifiez l’ID de la collection à obtenir. Cette valeur est la propriété CollectionID , par exemple ou XYZ00012SMS00001.

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

-Name

Spécifiez le nom de la collection à obtenir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.