Remove-AzRoleDefinition

Azure RBAC'de özel bir rolü siler. Silinecek rol, rolün Id özelliği kullanılarak belirtilir. Özel role yapılan mevcut rol atamaları varsa silme işlemi başarısız olur.

Syntax

RoleDefinitionIdParameterSet (Varsayılan)

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

Remove-AzRoleDefinition cmdlet'i Azure Role-Based Access Control'da özel bir rolü siler. Bu özel rolü silmek için mevcut bir özel rolün Id parametresini sağlayın. Varsayılan olarak, Remove-AzRoleDefinition sizden onay ister. İstemi engellemek için Force parametresini kullanın. Silinecek özel role yapılan mevcut rol atamaları varsa silme işlemi başarısız olur.

-PassThru parametresi kullanılırken, cmdlet silinen PSRoleDefinition nesnesini döndürür. Döndürülen nesne Actions, NotActions, DataActions, NotDataActions ve her izin girdisi için Attribute-Based Access Control (ABAC) koşulları (Condition ve ConditionVersion) içeren bir permissions koleksiyonu içerir.

Örnekler

Örnek 1: Get-AzRoleDefinition'dan boru kullanarak özel rolü kaldırma

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

"Sanal Makine Operatörü" özel rolünü alır ve silinmek üzere Remove-AzRoleDefinition için kanallar. Rol silinmeden önce sizden onay istenir.

Örnek 2: Kimliğine göre özel bir rolü kaldırma

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

Belirtilen kimlikle özel rolü siler. Sizden onay istenir.

Örnek 3: Onay olmadan özel rolü kaldırma

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

Onay istemeden "Özel Okuyucu Rolü" adlı özel rolü siler.

Örnek 4: Silinen rol tanımını kaldırma ve döndürme

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

Rolü siler ve PSRoleDefinition nesnesini döndürür, ardından ilk izin girdisinden eylemleri görüntüler.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik

Parametre özellikleri

Tür:IAzureContextContainer
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:AzContext, AzureRmContext, AzureCredential

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Force

Ayarlanırsa, özel rolü silmeden önce onay istemez

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Id

Silinecek Rol tanımının kimliği

Parametre özellikleri

Tür:Guid
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

RoleDefinitionIdParameterSet
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-InputObject

Kaldırılacak rol tanımını temsil eden nesne.

Parametre özellikleri

Tür:PSRoleDefinition
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

InputObjectParameterSet
Position:Named
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Name

Silinecek Rol tanımının adı.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

RoleDefinitionNameParameterSet
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-PassThru

Remove-AzRoleDefinition cmdlet'i Azure Role-Based Access Control'da özel bir rolü siler. Bu özel rolü silmek için mevcut bir özel rolün Id parametresini sağlayın. Varsayılan olarak, Remove-AzRoleDefinition sizden onay ister. İstemi engellemek için Force parametresini kullanın. Silinecek özel role yapılan mevcut rol atamaları varsa silme işlemi başarısız olur.

-PassThru parametresi kullanılırken, cmdlet silinen PSRoleDefinition nesnesini döndürür. Döndürülen nesne Actions, NotActions, DataActions, NotDataActions ve her izin girdisi için Attribute-Based Access Control (ABAC) koşulları (Condition ve ConditionVersion) içeren bir permissions koleksiyonu içerir.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Scope

Rol tanımı kapsamı.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

RoleDefinitionIdParameterSet
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False
RoleDefinitionNameParameterSet
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-SkipClientSideScopeValidation

Belirtilirse, istemci tarafı kapsam doğrulamayı atlayın.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

Remove-AzRoleDefinition cmdlet'i Azure Role-Based Access Control'da özel bir rolü siler. Bu özel rolü silmek için mevcut bir özel rolün Id parametresini sağlayın. Varsayılan olarak, Remove-AzRoleDefinition sizden onay ister. İstemi engellemek için Force parametresini kullanın. Silinecek özel role yapılan mevcut rol atamaları varsa silme işlemi başarısız olur.

-PassThru parametresi kullanılırken, cmdlet silinen PSRoleDefinition nesnesini döndürür. Döndürülen nesne Actions, NotActions, DataActions, NotDataActions ve her izin girdisi için Attribute-Based Access Control (ABAC) koşulları (Condition ve ConditionVersion) içeren bir permissions koleksiyonu içerir.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

Guid

String

PSRoleDefinition

Çıkışlar

Boolean

Notlar

Anahtar sözcükler: azure, azurerm, arm, kaynak, yönetim, yönetici, kaynak, grup, şablon, dağıtım