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