你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。

New-AzRoleDefinition

在 Azure RBAC 中创建自定义角色。 提供 JSON 角色定义文件或 PSRoleDefinition 对象作为输入。 首先,使用 Get-AzRoleDefinition 命令生成基线角色定义对象。 然后,根据需要修改其属性。 最后,使用此命令使用角色定义创建自定义角色。

语法

InputFileParameterSet

New-AzRoleDefinition
    [-InputFile] <String>
    [-SkipClientSideScopeValidation]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

RoleDefinitionParameterSet

New-AzRoleDefinition
    [-Role] <PSRoleDefinition>
    [-SkipClientSideScopeValidation]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

说明

New-AzRoleDefinition cmdlet 在 Azure Role-Based 访问控制 中创建自定义角色。 将角色定义作为命令的输入作为 JSON 文件或 PSRoleDefinition 对象提供。

输入角色定义必须包含以下属性:

  1. 名称:自定义角色的名称
  2. 说明:总结角色授予的访问权限的角色的简短说明。
  3. 权限:权限对象的数组,每个对象都包含 Actions 和/或 DataActions。 使用 Get-AzProviderOperation 获取可以使用 Azure RBAC 保护的Azure资源提供程序的操作。 下面是一些有效的操作字符串:
    • “*/read”授予对所有Azure资源提供程序的读取操作的访问权限。
    • “Microsoft。网络/*/read“授予对Microsoft中所有资源类型的读取操作的访问权限。Azure的网络资源提供程序。
    • “Microsoft。Compute/virtualMachines/*“ 授予对虚拟机及其子资源类型的所有操作的访问权限。
  4. AssignableScopes:可在其中分配自定义角色的作用域(Azure订阅或资源组)集。 下面是一些有效的可分配范围:
    • “/subscriptions/c276fc76-9cd4-44c9-99a7-4fd71546436e”, “/subscriptions/e91d47c4-76f3-4271-a796-21b4ecfe3624”:使角色可用于在两个订阅中分配。
    • “/subscriptions/c276fc76-9cd4-44c9-99a7-4fd71546436e”:使角色可用于在单个订阅中分配。
    • “/subscriptions/c276fc76-9cd4-44c9-99a7-4fd71546436e/resourceGroups/Network”:使角色仅适用于网络资源组中的分配。

Permissions 数组中每个权限对象可能包含:

  1. 操作:自定义角色向其授予访问权限的控制平面操作集。
  2. NotActions:必须从操作中排除的一组操作来确定有效操作。
  3. DataActions:自定义角色向其授予访问权限的数据平面操作集。
  4. NotDataActions:必须从 DataActions 中排除的操作集。
  5. 条件:限制权限的 Attribute-Based 访问控制 (ABAC) 条件。
  6. ConditionVersion:条件语法的版本,例如“2.0”(如果指定了 Condition,则是必需的)。

Note

Azure RBAC API 当前仅支持创建自定义角色时权限数组中的单个元素。 虽然数据模型支持多个权限条目,但创建操作必须使用一个权限对象。

下面是可作为输入提供的示例 JSON 角色定义:{ “Name”: “Custom VM Operator”, “Description”: “Can monitor all resources and restart virtual machines”, “Permissions”: [ { “Actions”: [ “/read”, “Microsoft”。Compute/virtualMachines/restart/action“, ”Microsoft。Compute/virtualMachines/start/action“ ], ”NotActions“: [ ”/write“ ], ”DataActions“: [ ”Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read“ ], ”NotDataActions“: [ ”Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write“ ] } ], ”AssignableScopes“: [”/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx“] }

示例

示例 1:使用 PSRoleDefinition 对象创建自定义角色

$role = New-Object -TypeName Microsoft.Azure.Commands.Resources.Models.Authorization.PSRoleDefinition
$role.Name = 'Virtual Machine Operator'
$role.Description = 'Can monitor, start, and restart virtual machines.'
$role.IsCustom = $true
$role.AssignableScopes = @("/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
$permission = New-Object -TypeName Microsoft.Azure.Commands.Resources.Models.Authorization.PSPermission
$permission.Actions = @(
    "Microsoft.Compute/*/read"
    "Microsoft.Compute/virtualMachines/start/action"
    "Microsoft.Compute/virtualMachines/restart/action"
    "Microsoft.Network/*/read"
    "Microsoft.Storage/*/read"
    "Microsoft.Authorization/*/read"
    "Microsoft.Resources/subscriptions/resourceGroups/read"
    "Microsoft.Resources/subscriptions/resourceGroups/resources/read"
    "Microsoft.Insights/alertRules/*"
    "Microsoft.Support/*"
)
$role.Permissions = @($permission)

New-AzRoleDefinition -Role $role

使用指定的操作创建名为“虚拟机操作员”的自定义角色。

示例 2:使用 JSON 文件创建自定义角色

New-AzRoleDefinition -InputFile C:\Temp\roleDefinition.json

从 JSON 定义文件创建自定义角色。

参数

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InputFile

包含单个 json 角色定义的文件名。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

InputFileParameterSet
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Role

角色定义对象。

参数属性

类型:PSRoleDefinition
默认值:None
支持通配符:False
不显示:False

参数集

RoleDefinitionParameterSet
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SkipClientSideScopeValidation

如果指定,请跳过客户端范围验证。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持以下常用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。

输入

None

输出

PSRoleDefinition

备注

关键字:azure, azurerm, arm, 资源, 管理, 经理, 资源组, 模板, 部署