Set-AzExpressRouteGateway
スケーラブルな ExpressRoute ゲートウェイを更新します。
構文
ByExpressRouteGatewayName (既定)
Set-AzExpressRouteGateway
-ResourceGroupName <String>
-Name <String>
[-MinScaleUnits <UInt32>]
[-MaxScaleUnits <UInt32>]
[-AllowNonVirtualWanTraffic <Boolean>]
[-Tag <Hashtable>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByExpressRouteGatewayObject
Set-AzExpressRouteGateway
-InputObject <PSExpressRouteGateway>
[-MinScaleUnits <UInt32>]
[-MaxScaleUnits <UInt32>]
[-AllowNonVirtualWanTraffic <Boolean>]
[-Tag <Hashtable>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByExpressRouteGatewayResourceId
Set-AzExpressRouteGateway
-ResourceId <String>
[-MinScaleUnits <UInt32>]
[-MaxScaleUnits <UInt32>]
[-AllowNonVirtualWanTraffic <Boolean>]
[-Tag <Hashtable>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-AzExpressRouteGateway コマンドレットを使用すると、既存の ExpressRouteGateway のスケール ユニットを更新したり、リソース タグを更新したりできます。
例
例 1
New-AzResourceGroup -Location "West US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName testRG -Name myVirtualWAN -Location "West US"
$virtualHub = New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.0.1/24"
New-AzExpressRouteGateway -ResourceGroupName "testRG" -Name "testergw" -VirtualHubId $virtualHub.Id -MinScaleUnits 2
Set-AzExpressRouteGateway -ResourceGroupName "testRG" -Name "testergw" -MinScaleUnits 3
ResourceGroupName : testRG
Name : testergw
Id : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/expressRouteGateways/testergw
Location : West US
MinScaleUnits : 3
Type : Microsoft.Network/expressRouteGateways
ProvisioningState : Succeeded
上記では、Azure のそのリソース グループに、リソース グループ "testRG"、Virtual WAN、および仮想ハブを米国西部に作成します。
その後、2 つのスケール ユニットを含む ExpressRoute ゲートウェイが仮想ハブに作成され、3 つのスケール ユニットに変更されます。
例 2: Virtual Wan 以外のネットワークからのトラフィックを受け入れるように、このゲートウェイを構成します。
ゲートウェイを取得し、その AllowNonVirtualWanTraffic プロパティを構成し、ゲートウェイに変更を保存するか、Set-AzExpressRouteGateway コマンドレットでスイッチを使用できます
# Option 1 - Retrieve the gateway object, configure it to allow traffic from VNets and persist those changes.
$gateway = Get-AzExpressRouteGateway -ResourceGroupName "resourceGroup001" -Name "gateway001"
$gateway.AllowNonVirtualWanTraffic = $true
$gateway = Set-AzExpressRouteGateway -InputObject $gateway
# Option 2 - Use the cmdlet switch
Set-AzExpressRouteGateway -ResourceGroupName "resourceGroup001" -Name "gateway001" -AllowNonVirtualWanTraffic $true
例 3: このゲートウェイを構成して、Virtual Wan 以外のネットワークからのトラフィックをブロックします。
ゲートウェイを取得し、その AllowNonVirtualWanTraffic プロパティを構成し、ゲートウェイに変更を保存するか、Set-AzExpressRouteGateway コマンドレットでスイッチを使用できます
# Option 1 - Retrieve the gateway object, configure it to block traffic from VNets and persist those changes.
$gateway=Get-AzExpressRouteGateway -ResourceGroupName "resourceGroup001" -Name "gateway001"
$gateway.AllowNonVirtualWanTraffic = $false
$gateway = Set-AzExpressRouteGateway -InputObject $gateway
# Option 2 - Use the cmdlet switch
Set-AzExpressRouteGateway -ResourceGroupName "resourceGroup001" -Name "gateway001" -AllowNonVirtualWanTraffic $false
パラメーター
-AllowNonVirtualWanTraffic
このゲートウェイが他の VNet からのトラフィックを受け入れる必要があるかどうかを判断します
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-AsJob
バックグラウンドでコマンドレットを実行する
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
パラメーターのプロパティ
型: IAzureContextContainer
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: AzContext, AzureRmContext, AzureCredential
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
更新する必要がある ExpressRouteGateway。
ByExpressRouteGatewayObject
配置: Named
必須: True
パイプラインからの値: True
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-MaxScaleUnits
この ExpressRouteGateway のスケール ユニットの最大数。 有効な範囲 > 2
パラメーターのプロパティ
型: UInt32
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-MinScaleUnits
この ExpressRouteGateway のスケール ユニットの最小数。 有効な範囲 > 2
パラメーターのプロパティ
型: UInt32
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Name
リソース名。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: ResourceName, ExpressRouteGatewayName, ゲートウェイ名
パラメーター セット
ByExpressRouteGatewayName
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ResourceGroupName
更新する ExpressRouteGateway のリソース グループ名。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
ByExpressRouteGatewayName
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ResourceId
更新する必要がある ExpressRouteGateway の ID。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
ByExpressRouteGatewayResourceId
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-Tag
リソース タグを表すハッシュテーブル。
パラメーターのプロパティ
型: Hashtable
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: 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 を参照してください。
出力