PowerShell创建Azure通知中心授权规则及主密钥来源问题
两个Azure PowerShell命令的实际落地情况
New-AzNotificationHubAuthorizationRule(针对单个通知中心创建授权规则)、New-AzNotificationHubsNamespaceAuthorizationRule(针对通知中心命名空间创建授权规则)都是Az.NotificationHubs模块的正式GA功能,不存在无法使用的问题,不少DevOps做自动化部署的时候都在生产环境用过,所谓“找不到实操案例”本质是官方文档把返回结构和入参逻辑写混了,导致大家看半天摸不着头脑。
核心疑问澄清
关于官方示例里的PrimaryKey来源
官方文档贴的带PrimaryKey的JSON片段,是命令执行成功后的返回对象结构,不是你调用命令时需要传入的入参格式——这也是绝大多数人看文档看懵的核心原因。
你在创建授权规则的过程中,完全不需要手动提前准备、传入PrimaryKey:
- 规则创建触发后,Azure后端会自动为你生成一对256位的base64编码密钥(也就是后续返回给你的PrimaryKey、SecondaryKey),这两个密钥就是用来生成SAS连接字符串、做访问鉴权的凭证,不存在“要自己找来源”的问题
- 只有当你后续调用更新类命令(比如
Set-AzNotificationHubsNamespaceAuthorizationRule)重置密钥、复用已有密钥的时候,才会涉及到密钥参数的传递,创建阶段完全不需要碰密钥相关的入参。
可直接运行的实操命令
首先确保执行环境安装了对应模块:Install-Module -Name Az.NotificationHubs -Force -AllowClobber
给命名空间创建授权规则
New-AzNotificationHubsNamespaceAuthorizationRule ` -ResourceGroupName "你的目标资源组名称" ` -Namespace "你的通知中心命名空间名称" ` -Name "自定义规则名,比如ContosoSendListenRule" ` -Rights @("Listen","Send")
命令执行成功后,返回的结果就和官方文档示例的JSON结构完全一致,里面会自动带出Azure生成的PrimaryKey、SecondaryKey。
给单个通知中心创建授权规则
New-AzNotificationHubAuthorizationRule ` -ResourceGroupName "你的目标资源组名称" ` -Namespace "你的通知中心命名空间名称" ` -NotificationHub "你的通知中心名称" ` -Name "自定义管理类规则名" ` -Rights @("Manage")
实操过程里的常见踩坑点
- 很多人照着官方文档的示例,把那段带PrimaryKey的JSON当入参往命令里塞,最后报参数匹配错误,本质是把命令的返回值结构和入参要求搞混了
-Rights参数必须传数组格式,就算只给一个权限,也要套上@(),直接传纯字符串会直接抛参数类型不匹配的错误- 同一个命名空间、同一个通知中心下的授权规则名称不能重复,撞名会直接创建失败报冲突
内容的提问来源于stack exchange,提问作者John McArthur
相关产品推荐
相关产品推荐

