通过

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

New-AzNotificationHubsNamespaceAuthorizationRule

  • 参考
模块:
Az.NotificationHubs

创建授权规则并将该规则分配给通知中心命名空间。

语法

New-AzNotificationHubsNamespaceAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-InputFile] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzNotificationHubsNamespaceAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-SASRule] <SharedAccessAuthorizationRuleAttributes>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-AzNotificationHubsNamespaceAuthorizationRule cmdlet 创建共享访问签名（SAS）授权规则，并将其分配给通知中心命名空间。 授权规则管理命名空间和该命名空间中包含的通知中心的用户权限。 此 cmdlet 提供了两种方法来创建新的授权规则并将其分配给命名空间。 可以创建 SharedAccessAuthorizationRuleAttributes 对象的实例，然后使用希望新规则拥有的属性值配置该对象。 可以使用 .NET Framework 完成此操作。 然后，可以使用 SASRule 参数将这些属性值复制到新规则。 或者，可以创建包含相关配置值的 JSON（JavaScript 对象表示法）文件，然后使用 InputFile 参数应用这些值。 JSON 文件是一个使用如下语法的文本文件： {
“Name”： “ContosoAuthorizationRule”，
“PrimaryKey”： “W******1Y=”，
“Rights”： [
“Listen”，
“发送”
]
} 与 New-AzNotificationHubsNamespaceAuthorizationRule cmdlet 结合使用时，前面的 JSON 示例将创建一个名为 ContosoAuthorizationRule 的授权规则，该规则为用户提供命名空间的侦听和发送权限。 用于身份验证的 PrimaryKey，可以使用以下 Windows PowerShell 命令随机生成：[Convert]：：ToBase64String（1..32 |% { [byte/]（Get-Random -Minimum 0 -Maximum 255） }）

示例

示例 1：创建授权规则并将其分配给命名空间

New-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationsGroup" -InputFile "C:\Configuration\NamespaceAuthorizationRules.json"

此命令创建授权规则，并将该规则分配给命名空间 ContosoNamespace。 创建此规则时，必须指定命名空间分配给的相应命名空间和资源组。 但是，无需指定有关规则本身的任何信息：规则信息将从输入文件 C:\Configuration\NamespaceAuthorizationRules.js获取。

参数

-Confirm

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

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

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

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputFile

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

类型:String
Position:2
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Namespace

指定要向其分配授权规则的命名空间。 命名空间提供了对通知中心进行分组和分类的方法。 必须将新规则分配给现有命名空间。 New-AzNotificationHubsNamespaceAuthorizationRule cmdlet 无法创建新命名空间。

类型:String
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ResourceGroup

指定为其分配命名空间的资源组。 资源组以仅清单管理和 Azure 管理的方式组织命名空间、通知中心和授权规则等项。 必须使用现有资源组。 此 cmdlet 无法创建新的资源组。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-SASRule

指定 SharedAccessAuthorizationRuleAttributes 对象，其中包含新规则的配置信息。

类型:SharedAccessAuthorizationRuleAttributes
Position:2
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-WhatIf

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

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

String

输出

SharedAccessAuthorizationRuleAttributes