Partager via

Remove-CMCollectionDirectMembershipRule

  • Référence
Module:
ConfigurationManager

Supprimer une règle d’appartenance directe d’un regroupement d’appareils ou d’utilisateurs.

Syntaxe

Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Utilisez cette applet de commande pour supprimer une règle d’appartenance directe d’un regroupement d’appareils ou d’utilisateurs. Une règle d’appartenance directe vous permet de choisir explicitement les membres de la collection. Les collections par défaut n’ont pas de règles d’appartenance directe. 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 directe d’une collection, la ressource peut ne plus être membre de la collection. Cette action peut empêcher tout déploiement de logiciel ou de configuration de s’appliquer à la ressource.

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 l’ordinateur local d’une collection d’appareils de test

Cet exemple utilise la variable d’environnement Windows ComputerName pour la supprimer de la collection nommée Appareils de test. Il utilise le paramètre Force pour ne pas demander de confirmation.

Remove-CMCollectionDirectMembershipRule -CollectionName 'Test Devices' -ResourceName $env:ComputerName -Force

Paramètres

-CollectionId

Spécifiez l’ID de la collection avec la règle directe à supprimer. Par exemple : "XYZ0003F".

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 avec la règle directe à supprimer.

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 de collection avec la règle directe à supprimer. 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

-Resource

Spécifiez un tableau d’objets de ressource à supprimer de la collection. Pour obtenir cet objet, utilisez les applets de commande Get-CMResource, Get-CMDevice ou Get-CMUser .

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

-ResourceId

Spécifiez un tableau d’ID de ressource à supprimer de la collection. Cette valeur est la propriété ResourceId de la classe SMS_Resource. Par exemple : "33555693".

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

-ResourceName

Spécifiez un tableau de noms de ressources à supprimer de la collection.

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

-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-CMDeviceCollectionDirectMembershipRule et Remove-CMUserCollectionDirectMembershipRule, qui sont spécifiques au type de collection. Cette applet de commande fonctionne avec des regroupements d’appareils ou d’utilisateurs.