Removes a group include assignment from one or more Intune policies.
Syntax
# By name (default)
Remove-LKPolicyAssignment
-GroupName <String>
-PolicyName <String[]>
[-NameMatch <String>]
[-SearchPolicyType <String[]>]
[-WhatIf] [-Confirm]
[<CommonParameters>]
# Pipeline
Remove-LKPolicyAssignment
-GroupName <String>
[-InputObject <PSCustomObject>]
[-WhatIf] [-Confirm]
[<CommonParameters>]
# By ID
Remove-LKPolicyAssignment
-GroupName <String>
-PolicyId <String>
[-PolicyType <String>]
[-WhatIf] [-Confirm]
[<CommonParameters>]
Description
Fetches the current assignments, removes the matching group include, and writes back the updated set. Policies that don’t include the group are silently skipped.
Parameters
-GroupName
Attribute
Value
Type
String
Required
Yes
-PolicyName
Attribute
Value
Type
String[]
Required
Yes (ByName)
-NameMatch
Attribute
Value
Type
String
Default
Contains
Valid values
Contains, Exact, Wildcard, Regex
-SearchPolicyType
Attribute
Value
Type
String[]
Required
No
-InputObject
Attribute
Value
Type
PSCustomObject
Pipeline
ByValue
-PolicyId
Attribute
Value
Type
String
Required
Yes (ById)
-PolicyType
Optional - auto-resolved if omitted.
Attribute
Value
Type
String
-WhatIf
Shows what would happen without performing the action.
Attribute
Value
Type
SwitchParameter
-Confirm
Prompts for confirmation before performing the action.