Share via

Update-AzureApplicationGateway

  • リファレンス
モジュール:
Azure

アプリケーション ゲートウェイを更新します。

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。

構文

Update-AzureApplicationGateway
      -Name <String>
      [-VnetName <String>]
      [-Subnets <System.Collections.Generic.List`1[System.String]>]
      [-InstanceCount <UInt32>]
      [-GatewaySize <String>]
      [-Description <String>]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

説明

Update-AzureApplicationGateway コマンドレットは、既存のアプリケーション ゲートウェイを更新します。

例

例 1: 名前を使用してアプリケーション ゲートウェイを変更する

PS C:\> Stop-AzureApplicationGateway -Name "ApplicationGateway06"
PS C:\> Update-AzureApplicationGateway -Name "ApplicationGateway06" -VnetName "VirutalNetwork18" -Subnets @("Subnet05", "Subnet06")

最初のコマンドは、ApplicationGateway06 という名前のアプリケーション ゲートウェイを停止します。 仮想ネットワークまたはサブネットを変更する前に、アプリケーション ゲートウェイを停止する必要があります。

2 番目のコマンドは、ApplicationGateway06 という名前のアプリケーション ゲートウェイの仮想サブネットとサブネットを変更します。

例 2: アプリケーション ゲートウェイの追加プロパティを変更する

PS C:\> Update-AzureApplicationGateway -Name "ApplicationGateway06" -InstanceCount 2 -GatewaySize "Large" -Description "Updated application gateway"

このコマンドは、ApplicationGateway06 という名前のアプリケーション ゲートウェイのインスタンス数、ゲートウェイ サイズ、および説明を変更します。 このコマンドは、アプリケーション ゲートウェイの仮想ネットワークまたはサブネットを変更しません。 そのため、このコマンドを実行する前にアプリケーション ゲートウェイを停止する必要はありません。

例 3: パイプラインを使用してアプリケーション ゲートウェイを変更する

PS C:\> $ApplicationGateway = Get-AzureApplicationGateway -Name "ApplicationGateway06"
PS C:\> $ApplicationGateway.GatewaySize = "Medium"
PS C:\> $ApplicationGateway | Update-AzureApplicationGateway

最初のコマンドは、Get-AzureApplicationGateway コマンドレットを使用して ApplicationGateway06 という名前のアプリケーション ゲートウェイを取得します。 このコマンドは、$ApplicationGateway変数に格納します。

2 番目のコマンドは、GatewaySize プロパティに値 Medium を割り当てます。

最後のコマンドは、更新された$ApplicationGatewayを現在のコマンドレットに渡します。

パラメーター

-Description

このコマンドレットがアプリケーション ゲートウェイに割り当てる説明を指定します。

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

-GatewaySize

このコマンドレットがアプリケーション ゲートウェイに割り当てるサイズを指定します。 有効な値は次のとおりです。

  • Small
  • Medium
  • Large
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-InstanceCount

このコマンドレットがアプリケーション ゲートウェイに割り当てるインスタンスの数を指定します。

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

-Name

このコマンドレットが更新するアプリケーション ゲートウェイの名前を指定します。

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

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

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

-Subnets

このコマンドレットがアプリケーション ゲートウェイをデプロイするサブネットの配列を指定します。

アプリケーション ゲートウェイの実行中にサブネットを更新することはできません。 アプリケーション ゲートウェイを停止するには、Stop-AzureApplicationGateway コマンドレットを使用します。

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VnetName

このコマンドレットがアプリケーション ゲートウェイをデプロイする仮想ネットワークを指定します。

アプリケーション ゲートウェイの実行中に仮想ネットワークを更新することはできません。 アプリケーション ゲートウェイを停止するには、Stop-AzureApplicationGateway を使用します。

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

入力

String

出力

Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse