Share via


New-AzNotificationHubAuthorizationRule

建立授權規則,並將規則指派給通知中樞。

Syntax

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

Description

New-AzNotificationHubAuthorizationRule Cmdlet 會建立通知中樞共用存取簽章 (SAS) 授權規則。 授權規則可用來管理通知中樞的存取權。 建立連結時,會根據不同的許可權等級,建立鏈接作為 URI 來完成。 用戶端會根據適當的許可權等級導向至下列其中一個 URI。 例如,指定 Listen 許可權的用戶端會導向至該許可權的 URI。

範例

範例 1:建立通知中樞授權規則

New-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -NotificationHub "ContosoInternalHub" -ResourceGroup "ContosoNotificationsGroup" -InputFile "C:\Configuration\ExternalAccessRule.json"

此命令會建立新的授權規則,並將它指派給名為 ContosoInternalHub 的通知中樞。 此中樞位於 ContosoNamespace 命名空間中,並指派給 ContosoNotificationsGroup 資源群組。 請注意,規則的所有組態資訊,包括規則名稱,都會取自輸入檔 C:\Configuration\ExternalAccessRule.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

指定此 Cmdlet 所建立之授權規則的輸入檔。

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

指定指派授權規則的命名空間。 命名空間提供分組和分類通知中樞的方式。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NotificationHub

指定將指派授權規則的通知中樞。 通知中樞可用來將推播通知傳送至多個用戶端,而不論這些用戶端所使用的平台為何。 請注意,您必須指定現有通知中樞的名稱。 New-AzNotificationHubAuthorizationRule Cmdlet 無法建立新的通知中樞。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroup

指定指派通知中樞的資源群組。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SASRule

指定 SharedAccessAuthorizationRuleAttributes 物件,其中包含新規則的組態資訊。

Type:SharedAccessAuthorizationRuleAttributes
Position:3
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

輸入

String

輸出

SharedAccessAuthorizationRuleAttributes