Remove-AzRoleDefinition

Modül:

Az.Resources Module

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

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

-AcquirePolicyToken

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alı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

-ChangeReference

Bu kaynak işleminin değişiklik başvuru kaynak kimliği.

Parametre özellikleri

Tür:	String
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

-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

İlişkili Bağlantılar

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