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

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

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

-Critical

名前空間が重要な名前空間であるかどうかを示します。 重要な名前空間は削除できません。 重要な名前空間を削除するには、名前空間を非クリティカルとしてマークするために、このプロパティの値を False に設定する必要があります。

Type:Boolean
Position:4
Default value:None
Required:False
Accept pipeline input:True
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

-Force

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

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

-Location

名前空間をホストするデータセンターの表示名を指定します。 このパラメーターは任意の有効な Azure の場所に設定できますが、最適なパフォーマンスを得るために、ほとんどのユーザーの近くにあるデータセンターを使用する必要があります。 Azure の場所の最新の一覧を取得するには、次のコマンドを実行します。 Get-AzLocation | Select-Object DisplayName

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

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

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

-State

名前空間の現在の状態を指定します。 このパラメーターに使用できる値は、Active と Disabled です。

Type:NamespaceState
Accepted values:Unknown, Active, Disabled
Position:3
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: -Tags @{Name="CalendarYear" というタグが作成されます。Value="2016"} 同じコマンドに複数のタグを追加するには、コンマを使用して個々のタグを区切ります: -Tag @{Name="CalendarYear";Value="2016"}, @{Name="FiscalYear";Value="2017"}

Type:Hashtable
Position:5
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

NamespaceState

Boolean

Hashtable

出力

NamespaceAttributes