Resize-AzVirtualNetworkGateway
Resizes an existing virtual network gateway.
Syntax
Resize-AzVirtualNetworkGateway
-VirtualNetworkGateway <PSVirtualNetworkGateway>
-GatewaySku <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
The Resize-AzVirtualNetworkGateway cmdlet enables you to change the stock-keeping unit (SKU) for a virtual network gateway. SKUs determine the capabilities of a gateway, including such things as throughput and the maximum number of IP tunnels that are allowed. Azure supports Basic, Standard, High-Performance, VpnGw1, VpnGw2 and VpnGw3 SKUs (sometimes referred to as Small, Medium, and Large SKUs). For detailed information about the capabilities of each SKU type, see https://azure.microsoft.com/en-us/documentation/articles/vpn-gateway-about-vpngateways/.
Keep in mind that SKUs differ in pricing as well as capabilities. For more information, see https://azure.microsoft.com/en-us/pricing/details/vpn-gateway/.
Examples
Example 1: Change the size of a virtual network gateway
PS C:\>$Gateway = Get-AzVirtualNetworkGateway -Name "ContosoVirtualGateway"
PS C:\> Resize-AzVirtualNetworkGateway -VirtualNetworkGateway $Gateway -GatewaySku "Basic"
This example changes the size of a virtual network gateway named ContosoVirtualGateway.
The first command creates an object reference to ContosoVirtualGateway; this object reference is stored in a variable named $Gateway.
The second command then uses the Resize-AzVirtualNetworkGateway cmdlet to set the GatewaySku property to Basic.
Parameters
-DefaultProfile
The credentials, account, tenant, and subscription used for communication with azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GatewaySku
Specifies the new type of gateway SKU. The acceptable values for this parameter are:
- Basic
- Standard
- High Performance
- VpnGw1
- VpnGw2
- VpnGw3
Type: | String |
Accepted values: | Basic, Standard, HighPerformance, UltraPerformance, VpnGw1, VpnGw2, VpnGw3 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VirtualNetworkGateway
Specifies an object reference to the virtual network gateway to be resized. You can create this object reference by using the Get-AzVirtualNetworkGateway and specifying the name of the gateway.
Type: | PSVirtualNetworkGateway |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Inputs
This cmdlet accepts pipelined instances of the Microsoft.Azure.Commands.Network.Models.PSVirtualNetworkGateway object.
Outputs
This cmdlet modifies existing instances of the Microsoft.Azure.Commands.Network.Models.PSVirtualNetworkGateway object.
Notes
You cannot resize from Basic/Standard/HighPerformance SKUs to the new VpnGw1/VpnGw2/VpnGw3 SKUs. See https://learn.microsoft.com/en-us/azure/vpn-gateway/vpn-gateway-about-vpngateways for instructions.