Get-AzNotificationHubListKey
通知ハブ承認規則に関連付けられているプライマリ接続文字列とセカンダリ接続文字列を取得します。
構文
Get-AzNotificationHubListKey
[-ResourceGroup] <String>
[-Namespace] <String>
[-NotificationHub] <String>
[-AuthorizationRule] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Get-AzNotificationHubListKey コマンドレットは、通知ハブ Shared Access Signature (SAS) 承認規則のプライマリ接続文字列とセカンダリ接続文字列を返します。 承認規則は、ハブに対するユーザー権限を管理します。 各規則には、プライマリ接続文字列とセカンダリ接続文字列が含まれます。 これらの接続文字列 (URI) は、次の処理を実行します。
- ユーザーをリソースにポイントします。
- クエリ パラメーターを含むトークンを含めます。 これらのパラメーターの 1 つである署名は、ユーザーを認証し、指定されたアクセス レベルを提供するために使用されます。
例
例 1: 承認規則のプライマリ接続文字列とセカンダリ接続文字列を取得する
Get-AzNotificationHubListKey -Namespace "ContosoNamespace" -NotificationHub "ContosoInternalHub" -ResourceGroup "ContosoNotificationsGroup" -AuthorizationRule "ListenRule"
このコマンドは、承認規則 ListenRule (ContosoInternalHub 通知ハブに割り当てられた規則) のプライマリ接続文字列とセカンダリ接続文字列を取得します。 このコマンドには、ハブ名前空間とリソース グループが含まれている必要があります。
パラメーター
-AuthorizationRule
Shared Access Signature (SAS) 認証規則の名前を指定します。 これらのルールによって、ユーザーが通知ハブに対して持つアクセスの種類が決まります。
型: | String |
配置: | 3 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
型: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Namespace
通知ハブが割り当てられる名前空間を指定します。 名前空間は、通知ハブをグループ化して分類する方法を提供します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-NotificationHub
このコマンドレットで承認規則を割り当てる通知ハブを指定します。 通知ハブは、それらのクライアントによって使用されるプラットフォームに関係なく、複数のクライアントにプッシュ通知を送信するために使用されます。
型: | String |
配置: | 2 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ResourceGroup
通知ハブが割り当てられるリソース グループを指定します。 リソース グループは、名前空間、通知ハブ、承認規則などの項目を、インベントリ管理と Azure 管理に役立つ方法で整理します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
出力
関連リンク
Azure PowerShell