New-AzureRmVpnGateway

Modulo:

AzureRM.Network

Crea un Gateway VPN scalabile.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

New-AzureRmVpnGateway
   -ResourceGroupName <String>
   -Name <String>
   -VpnGatewayScaleUnit <UInt32>
   -VirtualHubName <String>
   [-VpnConnection <PSVpnConnection[]>]
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmVpnGateway
   -ResourceGroupName <String>
   -Name <String>
   -VpnGatewayScaleUnit <UInt32>
   -VirtualHub <PSVirtualHub>
   [-VpnConnection <PSVpnConnection[]>]
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmVpnGateway
   -ResourceGroupName <String>
   -Name <String>
   -VpnGatewayScaleUnit <UInt32>
   -VirtualHubId <String>
   [-VpnConnection <PSVpnConnection[]>]
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

New-AzureRmVpnGateway crea un Gateway VPN scalabile. Si tratta della connettività definita dal software per le connessioni da sito a sito all'interno di VirtualHub.

Questo gateway viene ridimensionato e ridimensionato in base all'unità di scala specificata in questo o al cmdlet Set-AzureRmVpnGateway.

Una connessione viene configurata da un ramo/sito noto come VPNSite al gateway scalabile. Ogni connessione è costituita da 2 tunnel Active-Active.

VpnGateway si troverà nella stessa posizione di VirtualHub a cui si fa riferimento.

Esempio

Esempio 1

PS C:\> New-AzureRmResourceGroup -Location "West US" -Name "testRG"
PS C:\> $virtualWan = New-AzureRmVirtualWan -ResourceGroupName testRG -Name myVirtualWAN -Location "West US"
PS C:\> $virtualHub = New-AzureRmVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.0.1/24"
PS C:\> New-AzureRmVpnGateway -ResourceGroupName "testRG" -Name "testvpngw" -VirtualHubId $virtualHub.Id -BGPPeeringWeight 10 -VpnGatewayScaleUnit 2

ResourceGroupName   : testRG
Name                : testvpngw
Id                  : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/vpnGateways/testvpngw
Location            : West US
VpnGatewayScaleUnit : 2
VirtualHub          : /subscriptions/{subscriptionId}/resourceGroups/Ali_pS_Test/providers/Microsoft.Network/virtualHubs/westushub
BgpSettings         : {}
Type                : Microsoft.Network/vpnGateways
ProvisioningState   : Succeeded

In precedenza verrà creato un gruppo di risorse, rete WAN virtuale, Rete virtuale, hub virtuale negli Stati Uniti occidentali nel gruppo di risorse "testRG" in Azure. Un gateway VPN verrà creato successivamente nell'hub virtuale con 2 unità di scala.

Parametri

-AsJob

Eseguire il cmdlet in background

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-Name

Nome della risorsa.

Type:	String
Aliases:	ResourceName, VpnGatewayName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Nome della risorsa.

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

-Tag

Tabella hash che rappresenta i tag delle risorse.

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

-VirtualHub

VirtualHub a cui deve essere associato questo VpnGateway.

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

-VirtualHubId

L'ID di VirtualHub a cui deve essere associato questo VpnGateway.

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

-VirtualHubName

L'ID di VirtualHub a cui deve essere associato questo VpnGateway.

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

-VpnConnection

Elenco di vpn Connessione ions che questo VpnGateway deve avere.

Type:	PSVpnConnection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VpnGatewayScaleUnit

Unità di scala per questo VpnGateway.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Input

PSVirtualHub

String

Output

PSVpnGateway