Partager via

Get-CMCollectionMember

  • Référence
Module:
ConfigurationManager

Obtenir les membres d’un regroupement d’appareils ou d’utilisateurs.

Syntaxe

Get-CMCollectionMember
   -CollectionName <String>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollectionMember
   -CollectionId <String>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollectionMember
   -InputObject <IResultObject>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour obtenir les membres d’une collection. Les regroupements peuvent inclure des appareils ou des utilisateurs, mais pas les deux. Lorsque vous interrogez une collection, cette applet de commande retourne des objets pour tous les membres.

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 un membre d’une collection à l’aide de l’opérateur de pipeline

Cette commande utilise d’abord l’applet de commande Get-CMCollection pour obtenir l’objet de collection nommé UserCol1. Il utilise ensuite l’opérateur de pipeline pour passer l’objet à Get-CMCollectionMember, qui obtient tous les membres de la collection. Enfin, cet exemple utilise l’applet de commande Select-Object pour afficher uniquement les noms des membres.

Get-CMCollection -Name "UserCol1" | Get-CMCollectionMember | Select-Object Name

Exemple 2 : Obtenir un membre d’une collection par son nom

Cette commande interroge le regroupement DeviceCol1 pour les membres dont le nom commence par domain. Le caractère générique astérisque (*) correspond à plusieurs caractères. Les résultats peuvent donc inclure des noms tels que « domaine1 » ou « contrôleur de domaine ».

Get-CMCollectionMember -CollectionName "DeviceCol1" -Name "domain*"

Exemple 3 : Exporter les détails d’une collection vers un fichier CSV

Cet exemple interroge le regroupement d’appareils XYZ0004B pour obtenir un ensemble de propriétés et les stocke dans la variable , $collMem. La deuxième ligne convertit ces données au format CSV (valeurs séparées par des virgules) et les sorties en fichier.

$collMem = Get-CMCollectionMember -CollectionId "XYZ0004B" | Select-Object Name,Domain,LastLogonUser,DeviceOS,DeviceOSBuild,MACAddress,SerialNumber
$collMem | ConvertTo-Csv -NoTypeInformation | Out-File -FilePath "C:\output\XYZ0004B.csv"

Paramètres

-CollectionId

Spécifiez l’ID d’une collection à interroger. Par exemple : "XYZ0004B".

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

-CollectionName

Spécifiez le nom d’une collection à interroger.

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

-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

-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

-InputObject

Spécifiez un objet de collection à interroger. Pour obtenir un objet de collection, utilisez l’une des applets de commande suivantes :

Vous pouvez également utiliser l’opérateur de pipeline (|) pour passer un objet de collection à Get-CMCollectionMemeber sur la ligne de commande.

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

-Name

Pour filtrer les résultats, spécifiez le nom d’une ressource dans la collection. Ce filtre ne respecte pas la casse.

Vous pouvez utiliser des caractères génériques :

  • *: plusieurs caractères
  • ?: caractère unique
Type:String
Alias:ResourceName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-ResourceId

Pour filtrer les résultats, spécifiez un ID de ressource. Par exemple : 16777242. L’applet de commande retourne uniquement un enregistrement pour cette ressource dans la collection ciblée.

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

-SmsId

Pour filtrer les résultats, spécifiez l’ID SMS d’une ressource. Par exemple : "GUID:7a186367-7372-4841-889e-ba2e3aad1e85". Ce filtre ne respecte pas la casse.

Vous pouvez utiliser des caractères génériques :

  • *: plusieurs caractères
  • ?: caractère unique
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

System.Object