Partager via

Get-CMCollectionQueryMembershipRule

  • Référence
Module:
ConfigurationManager

Obtenir une règle d’appartenance à une requête pour un regroupement d’appareils ou d’utilisateurs.

Syntaxe

Get-CMCollectionQueryMembershipRule
   -CollectionName <String>
   [-RuleName <String>]
   [<CommonParameters>]
Get-CMCollectionQueryMembershipRule
   -CollectionId <String>
   [-RuleName <String>]
   [<CommonParameters>]
Get-CMCollectionQueryMembershipRule
   -InputObject <IResultObject>
   [-RuleName <String>]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour obtenir une ou plusieurs règles d’appartenance aux requêtes pour un regroupement d’appareils ou d’utilisateurs. Une règle de requête vous permet de mettre à jour dynamiquement l’appartenance d’une collection en fonction d’une requête exécutée selon une planification. Pour plus d’informations, consultez Guide pratique pour créer des regroupements dans Configuration Manager.

Pour plus d’informations sur les règles d’appartenance, 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 toutes les règles d’appartenance aux requêtes pour la collection Tous les systèmes

Cette commande obtient les règles d’appartenance aux requêtes à partir du regroupement d’appareils par défaut nommé Tous les systèmes.

Get-CMCollectionQueryMembershipRule -CollectionName "All Systems"

Exemple 2 : Afficher l’expression de requête d’une règle sur la collection Tous les utilisateurs

Cette commande obtient la règle d’appartenance à la requête nommée Tous les utilisateurs de la collection Tous les utilisateurs et retourne l’expression de requête.

Get-CMCollectionQueryMembershipRule -CollectionId "SMS00002" -RuleName "All Users" | Select-Object QueryExpression

Paramètres

-CollectionId

Spécifiez l’ID de la collection pour obtenir la règle. Cette valeur est la propriété CollectionID , par exemple, XYZ00012 ou SMS00001.

Type:String
Alias:Id
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 de la collection pour obtenir la règle.

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

-InputObject

Spécifiez un objet pour la collection afin d’obtenir la règle. Pour obtenir cet objet, utilisez les applets de commande Get-CMCollection, Get-CMDeviceCollection ou Get-CMUserCollection .

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

-RuleName

Spécifiez le nom de la règle de requête à obtenir à partir de la collection.

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:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object

Notes

Cette applet de commande est similaire à Get-CMDeviceCollectionQueryMembershipRule et Get-CMUserCollectionQueryMembershipRule, qui sont spécifiques au type de collection. Cette applet de commande fonctionne avec des regroupements d’appareils ou d’utilisateurs.