Remove-CMDeviceCollectionIncludeMembershipRule

Module:

ConfigurationManager

Supprimez une règle d’appartenance include d’un regroupement d’appareils.

Syntaxe

Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Utilisez cette applet de commande pour supprimer une règle d’appartenance include d’un regroupement d’appareils. Une règle d’appartenance include inclut les membres d’un autre regroupement dans les regroupements d’appareils où la règle est appliquée.

Pour plus d’informations, consultez Guide pratique pour créer des regroupements dans Configuration Manager.

Lorsque vous supprimez une règle d’appartenance include à un regroupement, une ressource peut ne plus être membre du regroupement d’appareils. Cette action peut empêcher tout déploiement de logiciel ou de configuration de s’appliquer à un appareil.

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 une règle d’appartenance include

Cette commande supprime la règle d’appartenance include pour le regroupement Tous les systèmes du regroupement d’appareils nommé Device. La spécification du paramètre Force indique que la règle d’appartenance est supprimée sans vous y inviter.

Remove-CMDeviceCollectionIncludeMembershipRule -CollectionName "Device" -IncludeCollectionName "All Systems" -Force

Exemple 2 : Supprimer une règle d’appartenance include à l’aide du pipeline

Cette commande utilise d’abord l’applet de commande Get-CMCollection pour obtenir l’objet de regroupement d’appareils nommé Device. Il utilise ensuite l’opérateur de pipeline pour passer l’objet à l’applet de commande Remove-CMDeviceCollectionIncludeMembershipRule .

Get-CMCollection -Name "Device" | Remove-CMDeviceCollectionIncludeMembershipRule -IncludeCollectionName "All Systems" -Force

Paramètres

-CollectionId

Spécifiez l’ID du regroupement d’appareils pour supprimer la règle. Cette valeur est la propriété CollectionID, par exemple . XYZ00012 Étant donné que les collections par défaut n’ont pas de règles d’appartenance include, 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 du regroupement d’appareils 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:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-IncludeCollection

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

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

-IncludeCollectionId

Spécifiez l’ID de la collection incluse pour supprimer la règle. Cette valeur est la propriété CollectionID, par exemple . XYZ00012 Vous pouvez inclure des collections par défaut, de sorte que cette valeur peut commencer par le code de site ou SMS.

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

-IncludeCollectionName

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

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

-InputObject

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

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

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

Liens associés

• Add-CMDeviceCollectionIncludeMembershipRule
• Get-CMDeviceCollectionIncludeMembershipRule
• Remove-CMCollectionIncludeMembershipRule
• Get-CMCollection
• Get-CMDeviceCollection
• Remove-CMUserCollectionIncludeMembershipRule
• Comment créer des regroupements dans Configuration Manager