Remove-CMDeviceCollectionDirectMembershipRule
Remove a direct membership rule from a device collection.
Syntax
Remove-CMDeviceCollectionDirectMembershipRule
-CollectionName <String>
-ResourceName <String[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionDirectMembershipRule
-CollectionName <String>
-Resource <IResultObject[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionDirectMembershipRule
-CollectionName <String>
-ResourceId <String[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionDirectMembershipRule
-CollectionId <String>
-Resource <IResultObject[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionDirectMembershipRule
-CollectionId <String>
-ResourceId <String[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionDirectMembershipRule
-CollectionId <String>
-ResourceName <String[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionDirectMembershipRule
-InputObject <IResultObject>
-Resource <IResultObject[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionDirectMembershipRule
-InputObject <IResultObject>
-ResourceId <String[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionDirectMembershipRule
-InputObject <IResultObject>
-ResourceName <String[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use this cmdlet to remove a direct membership rule from a device collection.
A direct membership rule lets you explicitly choose the members of the device collection.
Default collections don't have direct membership rules. Any collection that you target should have an ID that starts with the site code, not SMS
.
For more information, see How to create collections in Configuration Manager.
When you remove a direct membership rule from a collection, the resource may no longer be a member of the collection. This action can cause any software or configuration deployment to not apply to the device.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>
. For more information, see getting started.
Examples
Example 1: Remove a direct membership rule from a device collection
This command removes the direct membership rule for the resource with the ID of 2097152004 from the collection named Devices 01. Specifying the Force parameter indicates that the user isn't prompted before the rule is removed.
Remove-CMDeviceCollectionDirectMembershipRule -CollectionName "Devices 01" -ResourceId "2097152004" -Force
Parameters
-CollectionId
Specify the ID of a device collection with the direct rule to remove. For example, "XYZ0003F"
.
Type: | String |
Aliases: | Id |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Specify the name of the device collection with the direct rule to remove.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Run the command without asking for confirmation.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specify a device collection object with the direct rule to remove. To get this object, use the Get-CMCollection or Get-CMDeviceCollection cmdlets.
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Resource
Specify an array of device objects to remove its direct membership rule from the device collection. To get this object, use the Get-CMResource or Get-CMDevice cmdlets.
Type: | IResultObject[] |
Aliases: | Resources |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceId
Specify an array of resource IDs to remove the direct membership rules from the device collection. This value is the ResourceId property of the SMS_Resource class. For example, "33555693"
.
Type: | String[] |
Aliases: | ResourceIds |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceName
Specify an array of resource names to remove the direct membership rules from the device collection.
Type: | String[] |
Aliases: | ResourceNames |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet doesn't run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Outputs
System.Object