Get-CMCollectionMember

Référence

Module:: ConfigurationManager

Obtenir les membres d’un appareil ou d’une collection d’utilisateurs.

Syntax

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 cmdlet pour obtenir les membres d’une collection. Les collections peuvent inclure des appareils ou des utilisateurs, mais pas les deux. Lorsque vous interrogez une collection, cette cmdlet renvoie des objets pour tous les membres.

Pour plus d’informations, voir Présentation des collections dans Configuration Manager.

Notes

Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\> exemple. Pour plus d’informations, voir la mise en place.

Exemples

Exemple 1 : obtenir un membre d’une collection à l’aide de l’opérateur de pipeline

Cette commande utilise d’abord l’cmdlet Get-CMCollection pour obtenir l’objet de collection nommé UserCol1. Il utilise ensuite l’opérateur de pipeline pour transmettre l’objet à Get-CMCollectionMember, qui obtient tous les membres de la collection. Enfin, cet exemple utilise l’cmdlet 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 la collection 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 de la collection vers un CSV

Cet exemple interroge la collection d’appareils XYZ0004B pour un ensemble de propriétés et stocke celle-ci dans la variable, $collMem. La deuxième ligne convertit ces données au format CSV (valeurs séparées par des virgules) et est sortie dans un 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
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

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

-InputObject

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

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

Type:	IResultObject
Aliases:	Collection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Pour filtrer les résultats, spécifiez le nom d’une ressource dans la collection. Ce filtre n’est pas sensible à la cas.

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

*: Plusieurs caractères
?: Caractère unique

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

-ResourceId

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

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SmsId

Pour filtrer les résultats, spécifiez le SMSID d’une ressource. Par exemple: "GUID:7a186367-7372-4841-889e-ba2e3aad1e85". Ce filtre n’est pas sensible à la cas.