Udostępnij przez

Remove-AzRoleDefinition

Moduł:
Az.Resources Module

Usuwa rolę niestandardową w kontroli dostępu opartej na rolach platformy Azure. Rola, która ma zostać usunięta, jest określana przy użyciu właściwości Id roli. Usunięcie zakończy się niepowodzeniem, jeśli istnieją przypisania ról do roli niestandardowej.

Składnia

RoleDefinitionIdParameterSet (domyślnie) 

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

Opis

Polecenie cmdlet Remove-AzRoleDefinition usuwa rolę niestandardową w usłudze Azure Role-Based Access Control. Podaj parametr Id istniejącej roli niestandardowej, aby usunąć rolę niestandardową. Domyślnie Remove-AzRoleDefinition monituje o potwierdzenie. Aby pominąć monit, użyj parametru Force. Jeśli istnieją przypisania ról do roli niestandardowej do usunięcia, usunięcie zakończy się niepowodzeniem.

Przykłady

Przykład 1

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

Przykład 2

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

Parametry

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Force

W przypadku ustawienia nie wyświetla monitu o potwierdzenie przed usunięciem roli niestandardowej

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Id

Identyfikator definicji roli do usunięcia

Właściwości parametru

Typ:Guid
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

RoleDefinitionIdParameterSet
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-InputObject

Obiekt reprezentujący definicję roli do usunięcia.

Właściwości parametru

Typ:PSRoleDefinition
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

InputObjectParameterSet
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Nazwa definicji roli, która ma zostać usunięta.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

RoleDefinitionNameParameterSet
Position:0
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-PassThru

Polecenie cmdlet Remove-AzRoleDefinition usuwa rolę niestandardową w usłudze Azure Role-Based Access Control. Podaj parametr Id istniejącej roli niestandardowej, aby usunąć rolę niestandardową. Domyślnie Remove-AzRoleDefinition monituje o potwierdzenie. Aby pominąć monit, użyj parametru Force. Jeśli istnieją przypisania ról do roli niestandardowej do usunięcia, usunięcie zakończy się niepowodzeniem.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Scope

Zakres definicji roli.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

RoleDefinitionIdParameterSet
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False
RoleDefinitionNameParameterSet
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-SkipClientSideScopeValidation

Jeśli zostanie określony, pomiń walidację zakresu po stronie klienta.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Polecenie cmdlet Remove-AzRoleDefinition usuwa rolę niestandardową w usłudze Azure Role-Based Access Control. Podaj parametr Id istniejącej roli niestandardowej, aby usunąć rolę niestandardową. Domyślnie Remove-AzRoleDefinition monituje o potwierdzenie. Aby pominąć monit, użyj parametru Force. Jeśli istnieją przypisania ról do roli niestandardowej do usunięcia, usunięcie zakończy się niepowodzeniem.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

Guid

String

PSRoleDefinition

Dane wyjściowe

Boolean

Uwagi

Słowa kluczowe: azure, azurerm, arm, resource, management, manager, resource, group, template, deployment