Remove-AzRoleDefinition

Modul:
Az.Resources Module

Odstraní vlastní roli v Azure RBAC. Role, která se má odstranit, se zadává pomocí vlastnosti ID role. Odstranění selže, pokud existují přiřazení rolí k vlastní roli.

Syntax

RoleDefinitionIdParameterSet (Výchozí) 

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

Rutina Remove-AzRoleDefinition odstraní vlastní roli v Azure Role-Based Access Control. Zadejte parametr ID existující vlastní role pro odstranění této vlastní role. Ve výchozím nastavení vás Remove-AzRoleDefinition vyzve k potvrzení. Chcete-li potlačit výzvu, použijte parametr Force. Pokud existují přiřazení rolí k vlastní roli, která se mají odstranit, odstranění se nezdaří.

Při použití parametru -PassThru vrátí rutina odstraněný objekt PSRoleDefinition. Vrácený objekt obsahuje kolekci Permissions s Actions, NotActions, DataActions, NotDataActions a všechny Attribute-Based Access Control (ABAC) podmínky (Podmínka a ConditionVersion) pro každou položku oprávnění.

Příklady

Příklad 1: Odebrání vlastní role z Get-AzRoleDefinition

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

Načte vlastní roli Operátor virtuálního počítače a předá ji do Remove-AzRoleDefinition k odstranění. Před odstraněním role se zobrazí výzva k potvrzení.

Příklad 2: Odebrání vlastní role podle ID

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

Odstraní vlastní roli se zadaným ID. Zobrazí se výzva k potvrzení.

Příklad 3: Odebrání vlastní role bez potvrzení

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

Odstraní vlastní roli s názvem Vlastní role čtenáře bez výzvy k potvrzení.

Příklad 4: Odebrání a vrácení definice odstraněné role

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

Odstraní roli a vrátí PSRoleDefinition objekt a pak zobrazí akce z první položky oprávnění.

Parametry

-AcquirePolicyToken

Získejte token Azure Policy automaticky pro tuto operaci prostředku.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ChangeReference

ID zdroje odkazu na změnu pro tuto operaci prostředku.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Force

Pokud je tato možnost nastavená, nezobrazí se výzva k potvrzení před odstraněním vlastní role.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Id

ID definice role, která se má odstranit

Vlastnosti parametru

Typ:Guid
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

RoleDefinitionIdParameterSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-InputObject

Objekt představující definici role, která se má odebrat.

Vlastnosti parametru

Typ:PSRoleDefinition
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

InputObjectParameterSet
Position:Named
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Name

Název definice role, která se má odstranit.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

RoleDefinitionNameParameterSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-PassThru

Rutina Remove-AzRoleDefinition odstraní vlastní roli v Azure Role-Based Access Control. Zadejte parametr ID existující vlastní role pro odstranění této vlastní role. Ve výchozím nastavení vás Remove-AzRoleDefinition vyzve k potvrzení. Chcete-li potlačit výzvu, použijte parametr Force. Pokud existují přiřazení rolí k vlastní roli, která se mají odstranit, odstranění se nezdaří.

Při použití parametru -PassThru vrátí rutina odstraněný objekt PSRoleDefinition. Vrácený objekt obsahuje kolekci Permissions s Actions, NotActions, DataActions, NotDataActions a všechny Attribute-Based Access Control (ABAC) podmínky (Podmínka a ConditionVersion) pro každou položku oprávnění.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Scope

Obor definice role.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

RoleDefinitionIdParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
RoleDefinitionNameParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-SkipClientSideScopeValidation

Pokud je zadáno, přeskočte ověření oboru na straně klienta.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-WhatIf

Rutina Remove-AzRoleDefinition odstraní vlastní roli v Azure Role-Based Access Control. Zadejte parametr ID existující vlastní role pro odstranění této vlastní role. Ve výchozím nastavení vás Remove-AzRoleDefinition vyzve k potvrzení. Chcete-li potlačit výzvu, použijte parametr Force. Pokud existují přiřazení rolí k vlastní roli, která se mají odstranit, odstranění se nezdaří.

Při použití parametru -PassThru vrátí rutina odstraněný objekt PSRoleDefinition. Vrácený objekt obsahuje kolekci Permissions s Actions, NotActions, DataActions, NotDataActions a všechny Attribute-Based Access Control (ABAC) podmínky (Podmínka a ConditionVersion) pro každou položku oprávnění.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

Guid

String

PSRoleDefinition

Výstupy

Boolean

Poznámky

Klíčová slova: azure, azurerm, arm, resource, management, manager, resource, group, template, deployment