你当前正在访问 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 之前进行确认。
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 |
-InputFile
指定 JSON 文件的路径,其中包含新授权规则的配置信息。
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Namespace
指定要向其分配授权规则的命名空间。 命名空间提供了对通知中心进行分组和分类的方法。 必须将新规则分配给现有命名空间。 New-AzNotificationHubsNamespaceAuthorizationRule cmdlet 无法创建新命名空间。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroup
指定为其分配命名空间的资源组。 资源组以仅清单管理和 Azure 管理的方式组织命名空间、通知中心和授权规则等项。 必须使用现有资源组。 此 cmdlet 无法创建新的资源组。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SASRule
指定 包含新规则的配置信息的 SharedAccessAuthorizationRuleAttributes 对象。
Type: | SharedAccessAuthorizationRuleAttributes |
Position: | 2 |
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 |
输入
输出
SharedAccessAuthorizationRuleAttributes
相关链接
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈