Remove-AzRoleDefinition

Modul:

Az.Resources Module

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]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

RoleDefinitionNameParameterSet

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

InputObjectParameterSet

Remove-AzRoleDefinition
    -InputObject <PSRoleDefinition>
    [-SkipClientSideScopeValidation]
    [-Force]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<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.

När du använder parametern -PassThru returnerar cmdleten det borttagna PSRoleDefinition-objektet. Det returnerade objektet innehåller en behörighetssamling med Åtgärder, NotActions, DataActions, NotDataActions och eventuella Attribute-Based Access Control villkor (ABAC) (Villkor och ConditionVersion) för varje behörighetspost.

Exempel

Exempel 1: Ta bort en anpassad roll genom att skicka piping från Get-AzRoleDefinition

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

Hämtar den anpassade rollen "Virtual Machine Operator" och skickar den till Remove-AzRoleDefinition för borttagning. Du uppmanas att bekräfta innan rollen tas bort.

Exempel 2: Ta bort en anpassad roll efter ID

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

Tar bort den anpassade rollen med det angivna ID:t. Du uppmanas att bekräfta.

Exempel 3: Ta bort en anpassad roll utan bekräftelse

Remove-AzRoleDefinition -Name "Custom Reader Role" -Force

Tar bort den anpassade rollen med namnet "Anpassad läsarroll" utan att fråga efter bekräftelse.

Exempel 4: Ta bort och returnera definitionen för borttagen roll

$deletedRole = Remove-AzRoleDefinition -Name "Custom Writer Role" -Force -PassThru
$deletedRole.Permissions[0].Actions

Tar bort rollen och returnerar PSRoleDefinition-objektet och visar sedan åtgärderna från den första behörighetsposten.

Parametrar

-AcquirePolicyToken

Hämta en Azure Policy token automatiskt för den här resursåtgärden.

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

-ChangeReference

Resurs-ID för ändringsreferens för den här resursåtgärden.

Parameteregenskaper

Typ:	String
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

-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.

När du använder parametern -PassThru returnerar cmdleten det borttagna PSRoleDefinition-objektet. Det returnerade objektet innehåller en behörighetssamling med Åtgärder, NotActions, DataActions, NotDataActions och eventuella Attribute-Based Access Control villkor (ABAC) (Villkor och ConditionVersion) för varje behörighetspost.

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.

När du använder parametern -PassThru returnerar cmdleten det borttagna PSRoleDefinition-objektet. Det returnerade objektet innehåller en behörighetssamling med Åtgärder, NotActions, DataActions, NotDataActions och eventuella Attribute-Based Access Control villkor (ABAC) (Villkor och ConditionVersion) för varje behörighetspost.

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

Relaterade länkar

• New-AzRoleDefinition
• Get-AzRoleDefinition
• Set-AzRoleDefinition