Update-AzureApplicationGateway
更新應用程式閘道。
注意
本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet,請參閱 Az PowerShell 模組 。
Syntax
Update-AzureApplicationGateway
-Name <String>
[-VnetName <String>]
[-Subnets <System.Collections.Generic.List`1[System.String]>]
[-InstanceCount <UInt32>]
[-GatewaySize <String>]
[-Description <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
Update-AzureApplicationGateway Cmdlet 會更新現有的應用程式閘道。
範例
範例 1:使用其名稱修改應用程式閘道
PS C:\> Stop-AzureApplicationGateway -Name "ApplicationGateway06"
PS C:\> Update-AzureApplicationGateway -Name "ApplicationGateway06" -VnetName "VirutalNetwork18" -Subnets @("Subnet05", "Subnet06")
第一個命令會停止名為 ApplicationGateway06 的應用程式閘道。 您必須先停止應用程式閘道,才能修改虛擬網路或子網。
第二個命令會修改名為 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 Cmdlet 來取得名為 ApplicationGateway06 的應用程式閘道。 命令會將它儲存在 $ApplicationGateway 變數中。
第二個命令會將 GatewaySize 屬性指派為 Medium 值。
最後一個命令會將更新$ApplicationGateway傳遞至目前的 Cmdlet。
參數
-Description
指定此 Cmdlet 指派給應用程式閘道的描述。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-GatewaySize
指定此 Cmdlet 指派給應用程式閘道的大小。 有效值為:
- Small
- 中
- 大型
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstanceCount
指定此 Cmdlet 指派給應用程式閘道的實例數目。
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
指定此 Cmdlet 更新的應用程式閘道名稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔,此 Cmdlet 會從本機預設設定檔讀取。
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Subnets
指定此 Cmdlet 部署應用程式閘道的子網陣列。
應用程式閘道執行時,您無法更新子網。 若要停止應用程式閘道,請使用 Stop-AzureApplicationGateway Cmdlet。
Type: | List<T>[String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VnetName
指定此 Cmdlet 部署應用程式閘道的虛擬網路。
當應用程式閘道執行時,您無法更新虛擬網路。 若要停止應用程式閘道,請使用 Stop-AzureApplicationGateway 。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
輸入
輸出
Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse