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