Skip to main content

New-XdrEndpointDeviceRbacGroup

SYNOPSIS​

Creates a device group in Defender for Endpoint used for RBAC and policies.

SYNTAX​

New-XdrEndpointDeviceRbacGroup [[-GroupObject] <Object>] [-ProgressAction <ActionPreference>] [-WhatIf]
[-Confirm] [<CommonParameters>]

DESCRIPTION​

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.

EXAMPLES​

EXAMPLE 1​

New-XdrEndpointDeviceRbacGroup -GroupObject $customBody
Creates a device group in Defender for Endpoint used for RBAC and policies with a custom request body.

PARAMETERS​

-GroupObject​

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.

Type: Object
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf​

Shows what would happen if the command runs. The command is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm​

Prompts for confirmation before making changes.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProgressAction​

The ProgressAction parameter is a common parameter, not a cmdlet parameter. For more information, see about_CommonParameters.

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters​

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS​

OUTPUTS​

Object[]​

Returns the updated device group collection from the API.​

NOTES​