Remove-CMCollectionQueryMembershipRule

  • Référence
Module:
ConfigurationManager

Supprimez une règle d’appartenance à une requête d’un appareil ou d’une collection d’utilisateurs.

Syntax

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 cmdlet pour supprimer une règle d’appartenance à une requête d’un appareil ou d’une collection 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 qui est exécuté 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, voir Comment créer des collections 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 entraîner le non-application d’un déploiement de logiciel ou de configuration aux ressources.

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 : Supprimer les règles d’appartenance à une requête pour une collection d’appareils

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

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

Paramètres

- Confirmer

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

- WhatIf

Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionId

Spécifiez l’ID de la collection pour supprimer la règle. Cette valeur est la propriété CollectionID, par XYZ00012 exemple. É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 du site et non SMS par .

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

-CollectionName

Spécifiez le nom de la collection à supprimer de la règle.

Type:String
Aliases:Name
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Force

Exécutez la commande sans demander confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Spécifiez un objet pour la collection afin de supprimer la règle. Pour obtenir cet objet, utilisez les cmdlets Get-CMCollection, Get-CMDeviceCollectionou Get-CMUserCollection.

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-RuleName

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object

Notes

Cette cmdlet est similaire à Remove-CMDeviceCollectionQueryMembershipRule et Remove-CMUserCollectionQueryMembershipRule, qui sont spécifiques au type de collection. Cette cmdlet fonctionne avec les collections d’appareils ou d’utilisateurs.