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 コマンドレットは、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 |
入力
出力
SharedAccessAuthorizationRuleAttributes
関連リンク
Azure PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示