New-AzNotificationHubAuthorizationRule

モジュール:

Az.NotificationHubs

承認規則を作成し、その規則を通知ハブに割り当てます。

構文

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>]

説明

New-AzNotificationHubAuthorizationRule コマンドレットは、通知ハブ Shared Access Signature (SAS) 承認規則を作成します。 承認規則は、通知ハブへのアクセスを管理するために使用されます。 これは、さまざまなアクセス許可レベルに基づいて、URI としてリンクを作成することによって行われます。 クライアントは、適切なアクセス許可レベルに基づいて、これらの URI のいずれかに転送されます。 たとえば、リッスンアクセス許可を与えられたクライアントは、そのアクセス許可の URI に転送されます。

例

例 1: 通知ハブの承認規則を作成する

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

このコマンドは、新しい承認規則を作成し、ContosoInternalHub という名前の通知ハブに割り当てます。 このハブは ContosoNamespace 名前空間にあり、ContosoNotificationsGroup リソース グループに割り当てられます。 ルール名を含むルールのすべての構成情報は、入力ファイル C:\Configuration\ExternalAccessRule.json から取得されることに注意してください。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

このコマンドレットが作成する承認規則の入力ファイルを指定します。

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 コマンドレットは、新しい通知ハブを作成できません。

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

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

String

出力

SharedAccessAuthorizationRuleAttributes

関連リンク

• Get-AzNotificationHubAuthorizationRule
• Remove-AzNotificationHubAuthorizationRule
• Set-AzNotificationHubAuthorizationRule