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

New-AzureSBAuthorizationRule

创建新的服务总线授权规则。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧 Azure 资源。 创建新的资源时,不建议使用此旧版 PowerShell 模块,因为 ASM 计划停用。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

语法

New-AzureSBAuthorizationRule
   -Name <String>
   [-Permission <AccessRights[]>]
   -Namespace <String>
   -EntityName <String>
   -EntityType <ServiceBusEntityType>
   [-PrimaryKey <String>]
   [-SecondaryKey <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-AzureSBAuthorizationRule
   -Name <String>
   [-Permission <AccessRights[]>]
   -Namespace <String>
   [-PrimaryKey <String>]
   [-SecondaryKey <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

说明

New-AzureSBAuthorizationRule cmdlet 创建服务总线授权规则。

重要

服务总线的服务管理 REST API 将于 2021 年 11 月 1停用。 有关 API 停用的详细信息,请转到 弃用 Azure Service Manager 。 自 2021 年 11 月 1 日起,将不再支持适用于 服务总线的 Azure 服务管理 PowerShell cmdlet。 请迁移到新的 Azure PowerShell cmdlet

示例

示例 1:使用生成的主密钥创建授权规则

PS C:\> New-AzureSBAuthorizationRule -Name MyRule -Namespace MyNamespace -Permission $("Send")

使用 Send 权限在命名空间级别创建新的授权规则。

示例 2:通过提供主密钥创建授权规则

PS C:\> New-AzureSBAuthorizationRule -Name MyRule -Namespace MyNamespace -Permission $("Manage", "Listen", "Send") -EntityName MyEntity -EntityType Queue -PrimaryKey P+lL/Mnd2Z9sj5hwMrRyAxQDdX8RHfbdqU2eIAqs1rc=

使用所有权限在 MyEntity 队列级别创建新的授权规则。

参数

-EntityName

指定要在其中应用规则的实体名称。

类型:String
Position:Named
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False

-EntityType

指定实体类型。 有效值为:

  • 队列
  • 主题
  • 中继
  • NotificationHub
类型:ServiceBusEntityType
Position:Named
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定唯一的授权规则名称。

类型:String
Position:Named
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

指定要应用授权规则的命名空间名称。 如果未提供 EntityName,规则将位于命名空间级别。

类型:String
Position:Named
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

-Permission

授权权限(发送、管理、侦听)。

类型:AccessRights[]
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-PrimaryKey

指定共享访问签名主键。 如果未提供,将生成。

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-SecondaryKey

指定共享访问签名辅助密钥。

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False