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

New-AzNotificationHubsNamespaceAuthorizationRule

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

语法

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”: “WE4qH0398AyXjlekt56gg1gMR3NHoMs29KkUnnpUk01Y=”,
“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.json获取。

参数

-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