Dela via


Remove-AzRoleDefinition

Tar bort en anpassad roll i Azure RBAC. Den roll som ska tas bort anges med hjälp av ID-egenskapen för rollen. Borttagningen misslyckas om det finns befintliga rolltilldelningar till den anpassade rollen.

Syntax

RoleDefinitionIdParameterSet (Standard)

Remove-AzRoleDefinition
    -Id <Guid>
    [-Scope <String>]
    [-SkipClientSideScopeValidation]
    [-Force]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RoleDefinitionNameParameterSet

Remove-AzRoleDefinition
    [-Name] <String>
    [-Scope <String>]
    [-SkipClientSideScopeValidation]
    [-Force]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet

Remove-AzRoleDefinition
    -InputObject <PSRoleDefinition>
    [-SkipClientSideScopeValidation]
    [-Force]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cmdleten Remove-AzRoleDefinition tar bort en anpassad roll i Azure Role-Based Access Control. Ange ID-parametern för en befintlig anpassad roll för att ta bort den anpassade rollen. Som standard uppmanar Remove-AzRoleDefinition dig att bekräfta. Om du vill förhindra uppmaningen använder du force-parametern. Om det finns befintliga rolltilldelningar till den anpassade rollen som ska tas bort misslyckas borttagningen.

Exempel

Exempel 1

Get-AzRoleDefinition -Name "Virtual Machine Operator" | Remove-AzRoleDefinition

Exempel 2

Remove-AzRoleDefinition -Id "00001111-aaaa-2222-bbbb-3333cccc4444"

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Force

Om det anges uppmanar du inte till någon bekräftelse innan du tar bort den anpassade rollen

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Id

ID för rolldefinitionen som ska tas bort

Parameteregenskaper

Typ:Guid
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

RoleDefinitionIdParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-InputObject

Objektet som representerar rolldefinitionen som ska tas bort.

Parameteregenskaper

Typ:PSRoleDefinition
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

InputObjectParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

Namnet på den rolldefinition som ska tas bort.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

RoleDefinitionNameParameterSet
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-PassThru

Cmdleten Remove-AzRoleDefinition tar bort en anpassad roll i Azure Role-Based Access Control. Ange ID-parametern för en befintlig anpassad roll för att ta bort den anpassade rollen. Som standard uppmanar Remove-AzRoleDefinition dig att bekräfta. Om du vill förhindra uppmaningen använder du force-parametern. Om det finns befintliga rolltilldelningar till den anpassade rollen som ska tas bort misslyckas borttagningen.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Scope

Rolldefinitionsomfång.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

RoleDefinitionIdParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
RoleDefinitionNameParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-SkipClientSideScopeValidation

Om du anger det hoppar du över validering av klientsidans omfång.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

Cmdleten Remove-AzRoleDefinition tar bort en anpassad roll i Azure Role-Based Access Control. Ange ID-parametern för en befintlig anpassad roll för att ta bort den anpassade rollen. Som standard uppmanar Remove-AzRoleDefinition dig att bekräfta. Om du vill förhindra uppmaningen använder du force-parametern. Om det finns befintliga rolltilldelningar till den anpassade rollen som ska tas bort misslyckas borttagningen.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

Guid

String

PSRoleDefinition

Utdata

Boolean

Kommentarer

Nyckelord: azure, azurerm, arm, resource, management, manager, resource, group, template, deployment