Remove-CMCollectionIncludeMembershipRule

  • Référence
Module:
ConfigurationManager

Supprimez une règle d’appartenance Include d’un appareil ou d’une collection d’utilisateurs.

Syntax

Remove-CMCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Utilisez cette cmdlet pour supprimer une règle d’appartenance Include d’un appareil ou d’une collection d’utilisateurs. Une règle d’appartenance Include inclut les membres d’une autre collection de la collection dans laquelle la règle est appliquée.

Pour plus d’informations, voir Comment créer des collections dans Configuration Manager.

Lorsque vous supprimez une règle d’appartenance à une collection, il se peut qu’une ressource ne soit plus membre de la collection. Cette action peut entraîner le non-application d’un déploiement de logiciel ou de configuration à une ressource.

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

Cette commande supprime la règle d’appartenance Include pour la collection Tous les systèmes de la collection d’appareils nommée Devices. La spécification du paramètre Force indique que la règle d’appartenance est supprimée sans vous en être invité.

Remove-CMCollectionIncludeMembershipRule -CollectionName "Devices" -IncludeCollectionName "All Systems" -Force

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

Cette commande utilise d’abord l’cmdlet Get-CMCollection pour obtenir l’objet de collection d’utilisateurs nommé Users. Il utilise ensuite l’opérateur de pipeline pour transmettre l’objet à l’cmdlet Remove-CMCollectionIncludeMembershipRule.

Get-CMCollection -Name "Users" | Remove-CMCollectionIncludeMembershipRule -IncludeCollectionName "All Users" -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 les collections par défaut n’incluent pas de règles d’appartenance, 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

-IncludeCollection

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

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

-IncludeCollectionId

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

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

-IncludeCollectionName

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

Type:String
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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object

Notes

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