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