Get-AzNotificationHubAuthorizationRule

  • リファレンス
モジュール:
Az.NotificationHubs

通知ハブに関連付けられている承認規則に関する情報を取得します。

構文

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 認証規則の名前を指定します。 これらのルールによって、ユーザーが通知ハブに対して持つアクセスの種類が決まります。

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:True
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

-Namespace

通知ハブが割り当てられる名前空間を指定します。 名前空間は、通知ハブをグループ化して分類する方法を提供します。

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

-NotificationHub

このコマンドレットが承認規則を割り当てる通知ハブを指定します。 通知ハブは、それらのクライアントによって使用されるプラットフォームに関係なく、複数のクライアントにプッシュ通知を送信するために使用されます。

Type:String
Position:2
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

入力

String

出力

SharedAccessAuthorizationRuleAttributes