Get-CMCollection
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 XYZ00012
SMS00001
.
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.
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour