New-AzNotificationHubsNamespace
構文
Default (既定)
New-AzNotificationHubsNamespace
[-ResourceGroup] <String>
[-Namespace] <String>
[-Location] <String>
[[-Tag] <Hashtable>]
[[-SkuTier] <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
New-AzNotificationHubsNamespace コマンドレットは、通知ハブ名前空間を作成します。
名前空間は、通知ハブの整理と管理に役立つ論理コンテナーです。
少なくとも 1 つの通知ハブ名前空間が必要です。
1 つの名前空間に複数のハブを含めることができます。
ハブを整理したり、特定のユーザーにハブの選択されたサブセットを管理するアクセス許可を付与したりするために、複数の名前空間を持つことができます。
名前空間を作成するには、必ず名前空間の一意の名前を指定してください。名前空間が配置されるデータセンターを指定します。名前空間を割り当てるリソース グループを指定します。
名前空間が作成されたら、New-AzNotificationHubsNamespaceAuthorizationRules コマンドレットを使用して、その名前空間に承認規則を割り当てることができます。
承認規則は、名前空間へのアクセス許可を管理するために使用されます。
例
例 1: 通知ハブを作成する
New-AzNotificationHubsNamespace -ResourceGroup "ContosoNotificationsGroup" -Location "West US" -Namespace "ContosoPartners"
このコマンドにより、ContosoPartners という名前の通知ハブが作成されます。
名前空間は米国西部のデータセンターに配置され、ContosoNotificationsGroup リソース グループに割り当てられます。
例 2: タグを使用して通知ハブを作成する
New-AzNotificationHubsNamespace -ResourceGroup "ContosoNotificationsGroup" -Location "West US" -Namespace "ContosoPartners" -Tag @{Name="Audience";Value="PartnerOrganizations"}
このコマンドにより、ContosoPartners という名前の通知ハブが作成されます。
名前空間は米国西部のデータセンターに配置され、ContosoNotificationsGroup リソース グループに割り当てられます。
さらに、このコマンドは Audience という名前と値 PartnerOrganizations を持つタグを作成し、名前空間に割り当てます。
これにより、対象ユーザー タグが PartnerOrganizations に設定されているアイテムをフィルター処理するたびに、名前空間が表示されるようになります。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
パラメーターのプロパティ
| 型: | IAzureContextContainer
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Location
名前空間をホストするデータセンターの表示名を指定します。
このパラメーターは任意の有効な場所に設定できますが、最適なパフォーマンスを得るために、ユーザーの大半に近いデータセンターを使用することをお勧めします。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Namespace
新しい名前空間の名前を指定します。
名前空間は、通知ハブをグループ化して分類する方法を提供します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ResourceGroup
名前空間を割り当てるリソース グループを指定します。
リソース グループは、名前空間、通知ハブ、承認規則などの項目を、インベントリの管理と管理に役立つ方法で整理します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-SkuTier
名前空間の SKU レベル
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 4 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Tag
Azure 項目の分類と整理に使用できる名前と値のペアを指定します。
タグはキーワードと同様に機能し、デプロイ全体で動作します。
たとえば、Department:IT タグを持つすべてのアイテムを検索すると、アイテムの種類、場所、リソース グループなどに関係なく、そのタグを持つすべての Azure アイテムが返されます。
個々のタグは、 名前 と必要に応じて 値の 2 つの部分で構成されます。
たとえば、Department:IT では、タグ名は Department で、タグ値は IT です。
タグを追加するには、次のようなハッシュ テーブル構文を使用します。これにより、CalendarYear:2016 というタグが作成されます。
パラメーターのプロパティ
| 型: | Hashtable
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 3 |
| 必須: | False |
| パイプラインからの値: | 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を参照してください。
出力
