Get-CMCollectionQueryMembershipRule

  • Référence
Module:
ConfigurationManager

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

Syntax

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 How to create collections in Configuration Manager.

Pour plus d’informations sur les règles d’appartenance, consultez Présentation des regroupements 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 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 ou XYZ00012SMS00001.

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

-CollectionName

Spécifiez le nom de la collection pour obtenir la règle.

Type:String
Aliases:Name
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Aliases:Collection
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RuleName

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

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