Set-AzNotificationHubsNamespace
通知ハブ名前空間のプロパティ値を設定します。
構文
Set-AzNotificationHubsNamespace
[-ResourceGroup] <String>
[-Namespace] <String>
[-Location] <String>
[[-State] <NamespaceState>]
[[-Critical] <Boolean>]
[[-Tag] <Hashtable>]
[[-SkuTier] <String>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-AzNotificationHubsNamespace コマンドレットは、既存の通知ハブ名前空間のプロパティ値を設定します。 名前空間は、通知ハブの整理と管理に役立つ論理コンテナーです。 少なくとも 1 つの通知ハブ名前空間が必要です。 さらに、すべての通知ハブに名前空間が割り当てられている必要があります。 このコマンドレットは、主に名前空間を有効または無効にするために使用されます。 名前空間が無効になっている場合、ユーザーは名前空間内のどの通知ハブにも接続できず、管理者はこれらのハブを使用してプッシュ通知を送信することもできません。 無効になっている名前空間を再度有効にするには、このコマンドレットを使用して、名前空間の State プロパティを Active に設定します。 このコマンドレットを使用して、名前空間にクリティカルとしてタグを付けることもできます。 これにより、名前空間が削除されなくなります。 重要な名前空間を削除するには、まず Critical タグを削除する必要があります。
例
例 1: 名前空間を無効にする
Set-AzNotificationHubsNamespace -Namespace "ContosoPartners" -Location "West US" -ResourceGroup "ContosoNotificationsGroup" -State "Disabled" -SkuTier "Standard"
このコマンドを実行すると、米国西部のデータセンターにある ContosoPartners という名前の Standard レベルの名前空間が無効になり、ContosoNotificationsGroup リソース グループに割り当てられます。
例 2: 名前空間を有効にする
Set-AzNotificationHubsNamespace -Namespace "ContosoPartners" -Location "West US" -ResourceGroup "ContosoNotificationsGroup" -State "Active" -SkuTier "Standard"
このコマンドにより、米国西部のデータセンターに配置され、ContosoNotificationsGroup リソース グループに割り当てられている ContosoPartners という名前の Standard レベルの名前空間が有効になります。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Critical
名前空間が重要な名前空間であるかどうかを示します。 重要な名前空間は削除できません。 重要な名前空間を削除するには、名前空間を非クリティカルとしてマークするために、このプロパティの値を False に設定する必要があります。
型: | Boolean |
配置: | 4 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
型: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
確認を求めないでください。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Location
名前空間をホストするデータセンターの表示名を指定します。
このパラメーターは任意の有効な Azure の場所に設定できますが、最適なパフォーマンスを得るために、ほとんどのユーザーの近くにあるデータセンターを使用する必要があります。
Azure の場所の最新の一覧を取得するには、次のコマンドを実行します。 Get-AzLocation | Select-Object DisplayName
型: | String |
配置: | 2 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Namespace
このコマンドレットが変更する名前空間を指定します。 名前空間は、通知ハブをグループ化して分類する方法を提供します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ResourceGroup
名前空間が割り当てられているリソース グループを指定します。 リソース グループは、名前空間、通知ハブ、承認規則などの項目を、インベントリ管理と Azure 管理に役立つ方法で整理します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SkuTier
名前空間の SKU レベル
型: | String |
配置: | 4 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-State
名前空間の現在の状態を指定します。 このパラメーターに使用できる値は、Active と Disabled です。
型: | NamespaceState |
指定可能な値: | Unknown, Active, Disabled |
配置: | 3 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Tag
Azure 項目の分類と整理に使用できる名前と値のペアを指定します。 タグはキーワードと同様に機能し、デプロイ全体で動作します。 たとえば、Department:IT タグを持つすべてのアイテムを検索すると、アイテムの種類、場所、リソース グループなどに関係なく、そのタグを持つすべての Azure アイテムが返されます。 個々のタグは、 Name と (必要に応じて) Value の 2 つの部分で構成されます。 たとえば、Department:IT では、タグ名は Department で、タグ値は IT です。 タグを追加するには、次のようなハッシュ テーブル構文を使用します。これにより、CalendarYear:2016: -Tags @{Name="CalendarYear" というタグが作成されます。Value="2016"} 同じコマンドに複数のタグを追加するには、コンマを使用して個々のタグを区切ります: -Tag @{Name="CalendarYear";Value="2016"}, @{Name="FiscalYear";Value="2017"}
型: | Hashtable |
配置: | 5 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
出力
関連リンク
Azure PowerShell