Resize-AzureRmVirtualNetworkGateway

Ändert die Größe eines vorhandenen virtuellen Netzwerkgateways.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Resize-AzureRmVirtualNetworkGateway
      -VirtualNetworkGateway <PSVirtualNetworkGateway>
      -GatewaySku <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Resize-AzureRmVirtualNetworkGateway können Sie die Lagerhaltungseinheit (Stock-Keeping Unit, SKU) für ein virtuelles Netzwerkgateway ändern. SKUs bestimmen die Funktionen eines Gateways, z. B. Durchsatz und maximale Anzahl zulässiger IP-Tunnel. Azure-Support s Basic, Standard, High-Performance, VpnGw1, VpnGw2, VpnGw3, VpnGw1AZ, VpnGw2AZ, VpnGw3AZ, ErGw1AZ, ErGw2AZ, ErGw3AZ SKUs (manchmal auch als Small, Medium und Large SKUs bezeichnet). Ausführliche Informationen zu den Funktionen der einzelnen SKU-Typen finden Sie unter https://azure.microsoft.com/en-us/documentation/articles/vpn-gateway-about-vpngateways/. Beachten Sie, dass SICH SKUs in Preisen und Funktionen unterscheiden. Weitere Informationen finden Sie unter https://azure.microsoft.com/en-us/pricing/details/vpn-gateway/.

Beispiele

Beispiel 1: Ändern der Größe eines virtuellen Netzwerkgateways

PS C:\>$Gateway = Get-AzureRmVirtualNetworkGateway -Name "ContosoVirtualGateway"
PS C:\> Resize-AzureRmVirtualNetworkGateway -VirtualNetworkGateway $Gateway -GatewaySku "Basic"

In diesem Beispiel wird die Größe eines virtuellen Netzwerkgateways namens ContosoVirtualGateway geändert. Der erste Befehl erstellt einen Objektverweis auf ContosoVirtualGateway. Dieser Objektverweis wird in einer Variablen namens $Gateway gespeichert. Der zweite Befehl verwendet dann das Cmdlet Resize-AzureRmVirtualNetworkGateway , um die GatewaySku-Eigenschaft auf "Basic" festzulegen.

Parameter

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GatewaySku

Gibt den neuen Gateway-SKU-Typ an. Zulässige Werte für diesen Parameter:

  • Grundlegend
  • Standard
  • Leistung
  • VpnGw1
  • VpnGw2
  • VpnGw3
  • VpnGw1AZ
  • VpnGw2AZ
  • VpnGw3AZ
  • ErGw1AZ
  • ErGw2AZ
  • ErGw3AZ
Type:String
Accepted values:Basic, Standard, HighPerformance, UltraPerformance, VpnGw1, VpnGw2, VpnGw3, VpnGw1AZ, VpnGw2AZ, VpnGw3AZ, ErGw1AZ, ErGw2AZ, ErGw3AZ
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VirtualNetworkGateway

Gibt einen Objektverweis auf das virtuelle Netzwerkgateway an, das die Größe ändern soll. Sie können diesen Objektverweis mithilfe des Get-AzureRmVirtualNetworkGateway erstellen und den Namen des Gateways angeben.

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

Eingaben

PSVirtualNetworkGateway

Parameter: VirtualNetworkGateway (ByValue)

String

Ausgaben

PSVirtualNetworkGateway

Hinweise

Sie können die Größe nicht von Basic/Standard/HighPerformance-SKUs in die neuen VpnGw1/VpnGw2/VpnGw3-SKUs ändern. Weitere Größenänderungen sind nicht zulässig von/zu VpnGw1AZ/VpnGw2AZ/VpnGw3AZ oder ErGw1AZ/ErGw2AZ/ErGw3AZ. Die Größenänderung ist nur innerhalb der SKU -Serie zulässig, z. B. VpnGw1AZ kann in/von VpnGw2AZ/VpnGw3AZ und ErGw1AZ in/von ErGw2AZ/ErGw3AZ geändert werden. Anweisungen finden Sie https://docs.microsoft.com/en-us/azure/vpn-gateway/vpn-gateway-about-vpngateways unter.