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

Set-AzNotificationHubAuthorizationRule

设置通知中心的授权规则。

语法

Set-AzNotificationHubAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-NotificationHub] <String>
   [-InputFile] <String>
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzNotificationHubAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-NotificationHub] <String>
   [-SASRule] <SharedAccessAuthorizationRuleAttributes>
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-AzNotificationHubAuthorizationRule cmdlet 修改分配给通知中心的共享访问签名(SAS)授权规则。 授权规则通过基于不同权限级别创建链接(作为 URI)来管理对通知中心的访问权限。 权限级别可以是下列项之一:

  • 侦听
  • 发送
  • 管理客户端根据适当的权限级别定向到其中一个 URI。 例如,给定侦听权限的客户端将定向到该权限的 URI。 此 cmdlet 提供了两种方法来修改分配给通知中心的授权规则。 例如,可以创建 SharedAccessAuthorizationRuleAttributes 对象的实例,然后使用希望规则拥有的属性值配置该对象。 可以通过 .NET Framework 配置对象。 然后,可以使用 SASRule 参数将这些属性值复制到规则。 或者,可以创建包含相关配置值的 JSON(JavaScript 对象表示法)文件,然后通过 InputFile 参数应用这些值。 JSON 文件是一个使用如下语法的文本文件:{ “Name”: “ContosoAuthorizationRule”,
    “PrimaryKey”: “WE4qH0398AyXjlekt56gg1gMR3NHoMs29KkUnnpUk01Y=”,
    “Rights”: [
    "Listen",
    “发送”
    ]
    } 与 New-AzNotificationHubAuthorizationRule cmdlet 一起使用时,前面的 JSON 示例将修改名为 ContosoAuthorizationRule 的授权规则,以便向用户授予对中心的侦听和发送权限。

示例

示例 1:修改分配给通知中心的授权规则

Set-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationGroup" -NotificationHub "ContosoExternalHub" -InputFile "C:\Configuration\AuthorizationRules.json"

此命令修改分配给名为 ContosoExternalHub 的通知中心的授权规则。 必须指定中心所在的命名空间以及中心分配的资源组。 有关修改的规则的信息不包括在命令本身中。 而是在输入文件 C:\Configuration\AuthorizationRules.json中找到该信息。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

不要要求确认。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputFile

指定 JSON 文件的路径,其中包含新规则的配置信息。

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

指定通知中心分配到的命名空间。 命名空间提供了对通知中心进行分组和分类的方法。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NotificationHub

指定此 cmdlet 向其分配授权规则的通知中心。 通知中心用于向多个客户端发送推送通知,而不管这些客户端使用什么。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroup

指定通知中心分配到的资源组。 资源组以仅清单管理和 Azure 管理的方式组织命名空间、通知中心和授权规则等项。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SASRule

指定 SharedAccessAuthorizationRuleAttributes 对象,该对象包含修改的授权规则的配置信息。

Type:SharedAccessAuthorizationRuleAttributes
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

String

输出

SharedAccessAuthorizationRuleAttributes