Remove-IDRole

Remove-IDRole

SYNOPSIS

Delete one or more roles

SYNTAX

Remove-IDRole [[-Roles] <Array>] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Permanently deletes the specified roles from the tenant.

EXAMPLES

Example 1

PS C:\> Remove-IDRole -Roles 'Role Admins','Old Role'

Delete the specified roles

PARAMETERS

-Roles

An array of role names (or IDs) to delete. Accepts pipeline input by property name.

Type: Array
Parameter Sets: (All)
Aliases: Uuid

Required: False
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

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

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

-WhatIf

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

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

Required: False
Position: Named
Default value: False
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

System.Array

OUTPUTS

System.Object

NOTES