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 コマンドレットは、Shared Access Signature (SAS) 承認規則を作成し、それを通知ハブ名前空間に割り当てます。 承認規則は、名前空間とその名前空間に含まれる通知ハブに対するユーザー権限を管理します。 このコマンドレットには、新しい承認規則を作成して名前空間に割り当てる 2 つの方法があります。 SharedAccessAuthorizationRuleAttributes オブジェクトのインスタンスを作成し、新しいルールが所有するプロパティ値でそのオブジェクトを構成できます。 これは、.NET Framework を使用して行うことができます。 その後、SASRule パラメーターを使用して、これらのプロパティ値を新しいルールにコピーできます。 または、関連する構成値を含む JSON (JavaScript Object Notation) ファイルを作成し、InputFile パラメーターを使用してそれらの値を適用することもできます。 JSON ファイルは、次のような構文を使用するテキスト ファイルです。
"Name": "ContosoAuthorizationRule",
"PrimaryKey": "WE4qH0398AyXjlekt56gg1gMR3NHoMs29KkUnnpUk01Y=",
"Rights": [
"Listen",
"送信"
]
} New-AzNotificationHubsNamespaceAuthorizationRule コマンドレットと組み合わせて使用すると、前の 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

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

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 コマンドレットは、新しい名前空間を作成できません。

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

-ResourceGroup

名前空間が割り当てられているリソース グループを指定します。 リソース グループは、名前空間、通知ハブ、承認規則などの項目を、インベントリ管理と Azure 管理に役立つ方法で整理します。 既存のリソース グループを使用する必要があります。 このコマンドレットでは、新しいリソース グループを作成できません。

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

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

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

入力

String

出力

SharedAccessAuthorizationRuleAttributes