次の方法で共有

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": "W******1Y=",
"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.js入力ファイルから取得されます。

パラメーター

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

型:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputFile

新しい承認規則の構成情報を含む JSON ファイルへのパスを指定します。

型:String
配置:2
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Namespace

承認規則を割り当てる名前空間を指定します。 名前空間は、通知ハブをグループ化して分類する方法を提供します。 新しい規則は、既存の名前空間に割り当てる必要があります。 New-AzNotificationHubsNamespaceAuthorizationRule コマンドレットは、新しい名前空間を作成できません。

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ResourceGroup

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

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SASRule

新しい規則の構成情報を含む sharedAccessAuthorizationRuleAttributes オブジェクト を指定します。

型:SharedAccessAuthorizationRuleAttributes
配置:2
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

出力