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 |
入力
出力
Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse