Remove-AzRoleDefinition
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]
[<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
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
-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
