次の方法で共有


Update-AzureApplicationGateway

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

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される 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

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-GatewaySize

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

  • Small
  • Large
型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-InstanceCount

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

型:UInt32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Profile

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

型:AzureSMProfile
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Subnets

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

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

型:List<T>[String]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-VnetName

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

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

入力

String

出力

Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse