Partager via

Remove-CMCollectionQueryMembershipRule

  • Référence
Module:
ConfigurationManager

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

Syntaxe

Remove-CMCollectionQueryMembershipRule
      -InputObject <IResultObject>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionQueryMembershipRule
      -CollectionName <String>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionQueryMembershipRule
      -CollectionId <String>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Utilisez cette applet de commande pour supprimer une règle d’appartenance à une requête d’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. Vous ne pouvez pas supprimer les règles de requête des collections par défaut. Toute collection que vous ciblez doit avoir un ID qui commence par le code de site, et non SMS. Pour plus d’informations, consultez Guide pratique pour créer des regroupements dans Configuration Manager.

Lorsque vous supprimez une règle d’appartenance à une requête d’une collection, plusieurs ressources peuvent ne plus être membres de la collection. Cette action peut empêcher le déploiement de logiciels ou de configuration de s’appliquer aux ressources.

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 : Supprimer les règles d’appartenance aux requêtes pour un regroupement d’appareils

Cette commande supprime la règle d’appartenance aux requêtes nommée TPM du regroupement d’appareils nommé Appareils Windows 10.

Remove-CMCollectionQueryMembershipRule -CollectionName "Windows 10 devices" -RuleName "TPM" -Force

Paramètres

-CollectionId

Spécifiez l’ID de la collection pour supprimer la règle. Cette valeur est la propriété CollectionID, par exemple . XYZ00012 Étant donné que vous ne pouvez pas supprimer les règles de requête des collections par défaut, cet ID commence par le code de site et non SMSpar .

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 supprimer 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

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

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

-Force

Exécutez la commande sans demander de confirmation.

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

-InputObject

Spécifiez un objet pour la collection afin de supprimer 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 à supprimer de la collection.

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

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
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 à Remove-CMDeviceCollectionQueryMembershipRule et Remove-CMUserCollectionQueryMembershipRule, qui sont spécifiques au type de collection. Cette applet de commande fonctionne avec des regroupements d’appareils ou d’utilisateurs.