Get-AzNotificationHubAuthorizationRule
通知ハブに関連付けられている承認規則に関する情報を取得します。
構文
Get-AzNotificationHubAuthorizationRule
[-ResourceGroup] <String>
[-Namespace] <String>
[-NotificationHub] <String>
[[-AuthorizationRule] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Get-AzNotificationHubAuthorizationRule コマンドレットは、通知ハブに関連付けられている Shared Access Signature (SAS) 承認規則に関する情報を取得します。 コマンドレットは、ハブに関連付けられているすべての規則に関する情報を返すか、 AuthorizationRule パラメーターを含めることで、特定の規則に関する情報を取得します。 承認規則は、通知ハブへのアクセスを管理します。 承認規則では、さまざまなアクセス許可レベルに基づいて、URI としてリンクが作成されます。 クライアントは、適切なアクセス許可レベルに基づいて、これらの URI のいずれかに転送されます。 たとえば、Listen アクセス許可を持つクライアントは、そのアクセス許可の URI に転送されます。 Get-AzNotificationHubAuthorizationRule コマンドレットは、通知ハブに関連付けられている承認規則に関する情報のみを取得します。 ハブ自体に関する情報を取得するには、Get-AzNotificationHub を使用します。
例
例 1: 通知ハブに割り当てられているすべての承認規則の情報を取得する
Get-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationsGroup" -NotificationHub "ContosoInternalHub"
このコマンドは、名前空間 ContosoNamespace 内の ContosoInternalHub という名前の通知ハブに割り当てられているすべての承認規則の情報を取得します。 ハブが配置されている名前空間と、ハブが割り当てられているリソース グループを指定する必要があります。
例 2: 通知ハブに割り当てられた承認規則の情報を取得する
Get-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationsGroup" -NotificationHub "ContosoInternalHub" -AuthorizationRule "ListenRule"
このコマンドは、名前空間 ContosoNamespace 内の ContosoInternalHub という名前の通知ハブに割り当てられているすべての承認規則の情報を取得します。 このコマンドでは、 AuthorizationRule パラメーターを使用して、返されるデータを ListenRule という名前の単一の承認規則に制限します。
パラメーター
-AuthorizationRule
SAS 認証規則の名前を指定します。 これらのルールによって、ユーザーが通知ハブに対して持つアクセスの種類が決まります。
型: | String |
配置: | 3 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | 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 |
入力
出力
SharedAccessAuthorizationRuleAttributes
関連リンク
Azure PowerShell