Get-CMCollectionMember
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.
Vous pouvez utiliser des caractères génériques :
*
: Plusieurs caractères?
: Caractère unique
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
System.Object