POWERSHELL COMMAND
New-XdrEndpointDeviceRbacGroup
Creates a device group in Defender for Endpoint used for RBAC and policies.
Creates a device group in Defender for Endpoint used for RBAC and policies. After a successful create, this cmdlet refreshes the device-group cache for 30 minutes.
Syntax
New-XdrEndpointDeviceRbacGroup [[-GroupObject] <Object>] [-WhatIf] [-Confirm] [<CommonParameters>]
Parameters
-GroupObject
| Property | Value |
|---|---|
| Type | Object |
| Required | No |
| Position | 1 |
| Pipeline input | No |
| Default | Not documented |
Required. The group object to add to the existing RBAC group collection. This cmdlet does not build a default group object when the parameter is omitted.
-WhatIf
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | Not documented |
Shows what would happen if the command runs. The command is not run.
-Confirm
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | Not documented |
Prompts for confirmation before making changes.
Examples
New-XdrEndpointDeviceRbacGroup -GroupObject $customBody
Creates a device group in Defender for Endpoint used for RBAC and policies with a custom request body.
Output
Type: Object[]
Returns the updated device group collection from the API.