New-AzNotificationHub
構文
New-AzNotificationHub
[-ResourceGroup] <String>
[-Namespace] <String>
[-InputFile] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
NotificationHubParameterSet
New-AzNotificationHub
[-ResourceGroup] <String>
[-Namespace] <String>
[-NotificationHubObj] <NotificationHubAttributes>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
New-AzNotificationHub コマンドレットは、通知ハブを作成します。
通知ハブは、それらのクライアントによって使用されるプラットフォームに関係なく、複数のクライアントにプッシュ通知を送信するために使用されます。
通知ハブは、個々のアプリとほぼ同じです。通常、各アプリには独自の通知ハブがあります。
New-AzNotificationHub コマンドレットには、新しい通知ハブを作成する 2 つの方法があります。
NotificationHubAttributes オブジェクトのインスタンスを作成し、そのオブジェクトを構成できます。
その後、 NotificationHubObj パラメーターを使用して、これらのプロパティ値を新しいハブにコピーできます。
または、関連する構成値を含む JSON (JavaScript Object Notation) ファイルを作成し、 InputFile パラメーターを使用してそれらの値を適用することもできます。
New-AzNotificationHub コマンドレットと組み合わせて使用すると、上記の JSON サンプルでは、米国西部のデータセンターに ContosoNotificationHub という名前の通知ハブが作成されます。
例
例 1: 通知ハブを作成する
New-AzNotificationHub -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationsGroup" -InputFile "C:\Configurations\InternalHub.json"
このコマンドは、名前空間 ContosoNamespace に通知ハブを作成します。
新しいハブが ContosoNotificationsGroup に割り当てられます。
ハブの名前やその他の構成情報を指定する必要はありません。その情報は、C:\Configurations\InternalHub.js入力ファイルから取得されます。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
パラメーターのプロパティ
| 型: | IAzureContextContainer
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
新しい通知ハブの構成値を含む JSON ファイルへのパスを指定します。
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
InputFileParameterSet
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Namespace
通知ハブを割り当てる名前空間を指定します。
名前空間は、通知ハブをグループ化して分類する方法を提供します。
通知ハブは、既存の名前空間に割り当てる必要があります。
New-AzNotificationHub コマンドレットは、新しい名前空間を作成できません。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-NotificationHubObj
新しいハブの構成情報を含む NotificationHubAttributes オブジェクトを指定します。
パラメーターのプロパティ
パラメーター セット
NotificationHubParameterSet
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResourceGroup
通知ハブを割り当てるリソース グループを指定します。
リソース グループは、名前空間、通知ハブ、承認規則などの項目を、インベントリ管理と Azure 管理に役立つ方法で整理します。
既存のリソース グループを使用する必要があります。
New-AzNotificationHub コマンドレットは、新しいリソース グループを作成できません。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力