你当前正在访问 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”: “W******Y=”,
“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.js的输入文件中找到该信息。
参数
-Confirm
在运行 cmdlet 之前,提示你进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DefaultProfile
用于与 azure 通信的凭据、帐户、租户和订阅
类型: | IAzureContextContainer |
别名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Force
不要要求确认。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-InputFile
指定 JSON 文件的路径,其中包含新规则的配置信息。
类型: | String |
Position: | 3 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Namespace
指定通知中心分配到的命名空间。 命名空间提供了对通知中心进行分组和分类的方法。
类型: | String |
Position: | 1 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-NotificationHub
指定此 cmdlet 向其分配授权规则的通知中心。 通知中心用于向多个客户端发送推送通知,而不管这些客户端使用什么。
类型: | String |
Position: | 2 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-ResourceGroup
指定通知中心分配到的资源组。 资源组以仅清单管理和 Azure 管理的方式组织命名空间、通知中心和授权规则等项。
类型: | String |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-SASRule
指定 SharedAccessAuthorizationRuleAttributes 对象,该对象包含修改的授权规则的配置信息。
类型: | SharedAccessAuthorizationRuleAttributes |
Position: | 3 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
输出
SharedAccessAuthorizationRuleAttributes