Remove-CMCollectionDirectMembershipRule
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.
Liens associés
- Get-CMCollectionDirectMembershipRule
- Remove-CMCollectionExcludeMembershipRule
- Remove-CMCollectionIncludeMembershipRule
- Remove-CMCollectionQueryMembershipRule
- Add-CMDeviceCollectionDirectMembershipRule
- Add-CMUserCollectionDirectMembershipRule
- Get-CMDeviceCollectionDirectMembershipRule
- Get-CMUserCollectionDirectMembershipRule
- Get-CMCollection
- Get-CMDeviceCollection
- Get-CMUserCollection
- Get-CMResource
- Get-CMDevice
- Get-CMUser
- Comment créer des collections dans Configuration Manager