次の方法で共有


Set-AzNotificationHubAuthorizationRule

通知ハブの承認規則を設定します。

構文

Set-AzNotificationHubAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-NotificationHub] <String>
   [-InputFile] <String>
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzNotificationHubAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-NotificationHub] <String>
   [-SASRule] <SharedAccessAuthorizationRuleAttributes>
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzNotificationHubAuthorizationRule コマンドレットは、通知ハブに割り当てられた Shared Access Signature (SAS) 承認規則を変更します。 承認規則では、さまざまなアクセス許可レベルに基づいて、URI としてリンクを作成することで、通知ハブへのアクセスを管理します。 アクセス許可レベルには、次のいずれかを指定できます。

  • Listen
  • Send
  • 管理クライアントは、適切なアクセス許可レベルに基づいて、これらの URI のいずれかに転送されます。 たとえば、リッスンアクセス許可を与えられたクライアントは、そのアクセス許可の URI に転送されます。 このコマンドレットでは、通知ハブに割り当てられた承認規則を変更する 2 つの方法を提供します。 1 つの場合は、 SharedAccessAuthorizationRuleAttributes オブジェクトのインスタンスを作成し、ルールに保持するプロパティ値でそのオブジェクトを構成できます。 .NET Framework を使用してオブジェクトを構成できます。 その後、 SASRule パラメーターを使用して、これらのプロパティ値をルールにコピーできます。 または、関連する構成値を含む JSON (JavaScript Object Notation) ファイルを作成し、 InputFile パラメーターを使用してそれらの値を適用することもできます。 JSON ファイルは、{ "Name": "ContosoAuthorizationRule"、
    "PrimaryKey": "W******Y=",
    "Rights": [
    "Listen",
    "送信"
    ]
    } New-AzNotificationHubAuthorizationRule コマンドレットと組み合わせて使用すると、前の JSON サンプルでは、ユーザーにハブへのリッスン権限と送信権限を付与するために、ContosoAuthorizationRule という名前の承認規則が変更されます。

例 1: 通知ハブに割り当てられた承認規則を変更する

Set-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationGroup" -NotificationHub "ContosoExternalHub" -InputFile "C:\Configuration\AuthorizationRules.json"

このコマンドは、ContosoExternalHub という名前の通知ハブに割り当てられた承認規則を変更します。 ハブが配置されている名前空間と、ハブが割り当てられているリソース グループを指定する必要があります。 変更されたルールに関する情報は、コマンド自体には含まれません。 代わりに、その情報は入力ファイル C:\Configuration\AuthorizationRules.json にあります。

パラメーター

-Confirm

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

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

-DefaultProfile

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

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

-Force

確認を求めないでください。

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

-InputFile

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

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

-Namespace

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

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

-NotificationHub

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

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

-ResourceGroup

通知ハブが割り当てられるリソース グループを指定します。 リソース グループは、名前空間、通知ハブ、承認規則などの項目を、インベントリ管理と Azure 管理に役立つ方法で整理します。

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

-SASRule

変更される承認規則の構成情報を含む SharedAccessAuthorizationRuleAttributes オブジェクトを指定します。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

入力

String

出力

SharedAccessAuthorizationRuleAttributes