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

Set-AzureSBAuthorizationRule

更新现有服务总线授权规则。

注意

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

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

EntitySAS

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

NamespaceSAS

Set-AzureSBAuthorizationRule
    -Name <String>
    -Namespace <String>
    [-Permission <AccessRights[]>]
    [-PrimaryKey <String>]
    [-SecondaryKey <String>]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

说明

更新现有服务总线授权规则。

重要

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

示例

示例 1:为命名空间级别的授权规则续订主密钥

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

主密钥会续订。

示例 2:更新授权规则权限

PS C:\> Set-AzureSBAuthorizationRule -Name MyRule -Namespace MyNamespace -Permission $("Listen", "Send") -EntityName MyEntity -EntityType Queue

更新权限。

参数

-EntityName

要应用规则的实体名称。

参数属性

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

参数集

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

-EntityType

实体类型(队列、主题、中继、NotificationHub)。

参数属性

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

参数集

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

-Name

唯一的授权规则名称。

参数属性

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

参数集

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

-Namespace

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

参数属性

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

参数集

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

-Permission

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

参数属性

类型:

AccessRights[]

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

参数集

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

-PrimaryKey

共享访问签名主密钥。 如果未提供,将生成。

参数属性

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

参数集

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

-Profile

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

参数属性

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

参数集

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

-SecondaryKey

共享访问签名辅助密钥。

参数属性

类型:String
默认值: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