Remove-CMCollectionDirectMembershipRule

  • Référence
Module:
ConfigurationManager

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

Syntax

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 cmdlet pour supprimer une règle d’appartenance directe d’un appareil ou d’une collection 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 directes. 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 directe d’une collection, il se peut que la 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 à la 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 l’ordinateur local d’une collection de périphériques de test

Cet exemple utilise la variable Windows’environnement computerName pour la supprimer de la collection nommée Test Devices. Il utilise le paramètre Force pour ne pas obtenir de confirmation.

Remove-CMCollectionDirectMembershipRule -CollectionName 'Test Devices' -ResourceName $env:ComputerName -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 avec la règle directe à supprimer. Par exemple: "XYZ0003F".

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

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

-Resource

Spécifiez un tableau d’objets de ressources à supprimer de la collection. Pour obtenir cet objet, utilisez les cmdlets Get-CMResource, Get-CMDeviceou Get-CMUser.

Type:IResultObject[]
Aliases:Resources
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ResourceId

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

Type:String[]
Aliases:ResourceIds
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ResourceName

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

Type:String[]
Aliases:ResourceNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object

Notes

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