New-AzNotificationHubsNamespace

モジュール:

Az.NotificationHubs

通知ハブの名前空間を作成します。

構文

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

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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

-Location

名前空間をホストするデータセンターの表示名を指定します。 このパラメーターは任意の有効な場所に設定できますが、最適なパフォーマンスを得るために、ユーザーの大半に近いデータセンターを使用することをお勧めします。

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

-Namespace

新しい名前空間の名前を指定します。 名前空間は、通知ハブをグループ化して分類する方法を提供します。

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

-ResourceGroup

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

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

-SkuTier

名前空間の SKU レベル

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

-Tag

Azure 項目の分類と整理に使用できる名前と値のペアを指定します。 タグはキーワード (keyword)と同様に機能し、デプロイ全体で動作します。 たとえば、Department:IT タグを持つすべてのアイテムを検索すると、アイテムの種類、場所、リソース グループなどに関係なく、そのタグを持つすべての Azure アイテムが返されます。 個々のタグは、名前と必要に応じて値の 2 つの部分で構成されます。 たとえば、Department:IT では、タグ名は Department で、タグ値は IT です。 タグを追加するには、次のようなハッシュ テーブル構文を使用します。これにより、CalendarYear:2016 というタグが作成されます。

Type:	Hashtable
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

String

Hashtable

出力

NamespaceAttributes

関連リンク

• Get-AzNotificationHubsNamespace
• Remove-AzNotificationHubsNamespace
• Set-AzNotificationHubsNamespace