Edit

Share via

New-AzP2sVpnGateway

  • Reference
Module:
Az.Network

Create a new P2SVpnGateway under VirtualHub for point to site connectivity.

Syntax

New-AzP2sVpnGateway
   -ResourceGroupName <String>
   -Name <String>
   -VpnGatewayScaleUnit <UInt32>
   -VirtualHubName <String>
   [-VpnServerConfiguration <PSVpnServerConfiguration>]
   [-VpnClientAddressPool <String[]>]
   [-CustomDnsServer <String[]>]
   [-RoutingConfiguration <PSRoutingConfiguration>]
   [-EnableInternetSecurityFlag]
   [-DisableInternetSecurityFlag]
   [-EnableRoutingPreferenceInternetFlag]
   [-P2SConnectionConfiguration <PSP2SConnectionConfiguration[]>]
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzP2sVpnGateway
   -ResourceGroupName <String>
   -Name <String>
   -VpnGatewayScaleUnit <UInt32>
   -VirtualHubName <String>
   -VpnServerConfigurationId <String>
   [-VpnClientAddressPool <String[]>]
   [-CustomDnsServer <String[]>]
   [-RoutingConfiguration <PSRoutingConfiguration>]
   [-EnableInternetSecurityFlag]
   [-DisableInternetSecurityFlag]
   [-EnableRoutingPreferenceInternetFlag]
   [-P2SConnectionConfiguration <PSP2SConnectionConfiguration[]>]
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzP2sVpnGateway
   -ResourceGroupName <String>
   -Name <String>
   -VpnGatewayScaleUnit <UInt32>
   -VirtualHub <PSVirtualHub>
   [-VpnServerConfiguration <PSVpnServerConfiguration>]
   [-VpnClientAddressPool <String[]>]
   [-CustomDnsServer <String[]>]
   [-RoutingConfiguration <PSRoutingConfiguration>]
   [-EnableInternetSecurityFlag]
   [-DisableInternetSecurityFlag]
   [-EnableRoutingPreferenceInternetFlag]
   [-P2SConnectionConfiguration <PSP2SConnectionConfiguration[]>]
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzP2sVpnGateway
   -ResourceGroupName <String>
   -Name <String>
   -VpnGatewayScaleUnit <UInt32>
   -VirtualHub <PSVirtualHub>
   -VpnServerConfigurationId <String>
   [-VpnClientAddressPool <String[]>]
   [-CustomDnsServer <String[]>]
   [-RoutingConfiguration <PSRoutingConfiguration>]
   [-EnableInternetSecurityFlag]
   [-DisableInternetSecurityFlag]
   [-EnableRoutingPreferenceInternetFlag]
   [-P2SConnectionConfiguration <PSP2SConnectionConfiguration[]>]
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzP2sVpnGateway
   -ResourceGroupName <String>
   -Name <String>
   -VpnGatewayScaleUnit <UInt32>
   -VirtualHubId <String>
   [-VpnServerConfiguration <PSVpnServerConfiguration>]
   [-VpnClientAddressPool <String[]>]
   [-CustomDnsServer <String[]>]
   [-RoutingConfiguration <PSRoutingConfiguration>]
   [-EnableInternetSecurityFlag]
   [-DisableInternetSecurityFlag]
   [-EnableRoutingPreferenceInternetFlag]
   [-P2SConnectionConfiguration <PSP2SConnectionConfiguration[]>]
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzP2sVpnGateway
   -ResourceGroupName <String>
   -Name <String>
   -VpnGatewayScaleUnit <UInt32>
   -VirtualHubId <String>
   -VpnServerConfigurationId <String>
   [-VpnClientAddressPool <String[]>]
   [-CustomDnsServer <String[]>]
   [-RoutingConfiguration <PSRoutingConfiguration>]
   [-EnableInternetSecurityFlag]
   [-DisableInternetSecurityFlag]
   [-EnableRoutingPreferenceInternetFlag]
   [-P2SConnectionConfiguration <PSP2SConnectionConfiguration[]>]
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-AzP2sVpnGateway cmdlet enables you to create a new P2SVpnGateway under VirtualHub for Point to site connectivity from Point to site clients to Azure VirtualWan.

Examples

Example 1

$virtualHub = Get-AzVirtualHub -ResourceGroupName P2SCortexGATesting -Name WestUsVirtualHub
$vpnServerConfig1 = Get-AzVpnServerConfiguration -ResourceGroupName P2SCortexGATesting -Name WestUsConfig
$vpnClientAddressSpaces = New-Object string[] 1
$vpnClientAddressSpaces[0] = "192.168.2.0/24"
$createdP2SVpnGateway = New-AzP2sVpnGateway -ResourceGroupName P2SCortexGATesting -Name 683482ade8564515aed4b8448c9757ea-westus-gw -VirtualHub $virtualHub -VpnGatewayScaleUnit 1 -VpnClientAddressPool $vpnClientAddressSpaces -VpnServerConfiguration $vpnServerConfig1 -EnableInternetSecurityFlag -EnableRoutingPreferenceInternetFlag

ResourceGroupName              : P2SCortexGATesting
Name                           : 683482ade8564515aed4b8448c9757ea-westus-gw
Id                             : /subscriptions/b1f1deed-af60-4bab-9223-65d340462e24/resourceGroups/P2SCortexGATesting/providers/Microsoft.Network/p2sVpnGateways/683482ade8564515a
                                 ed4b8448c9757ea-westus-gw
Location                       : westus
VpnGatewayScaleUnit            : 1
VirtualHub                     : /subscriptions/b1f1deed-af60-4bab-9223-65d340462e24/resourceGroups/P2SCortexGATesting/providers/Microsoft.Network/virtualHubs/WestUsVirtualHub
VpnServerConfiguration         : /subscriptions/b1f1deed-af60-4bab-9223-65d340462e24/resourceGroups/P2SCortexGATesting/providers/Microsoft.Network/vpnServerConfigurations/WestUsConfig
VpnServerConfigurationLocation :
VpnClientConnectionHealth      : null
Type                           : Microsoft.Network/p2sVpnGateways
ProvisioningState              : Succeeded
P2SConnectionConfigurations    : [
                                   {
                                     "ProvisioningState": "Succeeded",
                                     "VpnClientAddressPool": {
                                       "AddressPrefixes": [
                                         "192.168.2.0/24"
                                       ]
                                     },
                                     "EnableInternetSecurity": True,
                                     "RoutingConfiguration": {
                                       "AssociatedRouteTable": {
                                         "Id": "/subscriptions/b1f1deed-af60-4bab-9223-65d340462e24/resourceGroups/P2SCortexGATesting/providers/Microsoft.Network/virtualHubs/WestUsVirtualHub/hubRouteTables/defaultRouteTable"
                                       }
                                       "PropagatedRouteTables": {
                                         "Labels": [],
                                         "Ids": [
                                           {
                                            "Id": "/subscriptions/b1f1deed-af60-4bab-9223-65d340462e24/resourceGroups/P2SCortexGATesting/providers/Microsoft.Network/virtualHubs/WestUsVirtualHub/hubRouteTables/defaultRouteTable"
                                           }
                                        ]
                                       },
                                       "VnetRoutes": {
                                         "StaticRoutes": []
                                       }
                                     },
                                     "Name": "P2SConnectionConfigDefault",
                                     "Etag": "W/\"4b96e6a2-b4d8-46b3-9210-76d40f359bef\"",
                                     "Id": "/subscriptions/b1f1deed-af60-4bab-9223-65d340462e24/resourceGroups/P2SCortexGATesting/providers/Microsoft.Network/p2sVpnGateways/683482
                                 ade8564515aed4b8448c9757ea-westus-gw/p2sConnectionConfigurations/P2SConnectionConfigDefault"
                                   }
                                 ]

The New-AzP2sVpnGateway cmdlet enables you to create a new P2SVpnGateway under VirtualHub for Point to site connectivity.

Parameters

-AsJob

Run cmdlet in the background

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

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-CustomDnsServer

The list of Custom Dns Servers.

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

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

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

-DisableInternetSecurityFlag

Flag to disable internet security feature on this P2SVpnGateway P2SConnectionConfiguration.

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

-EnableInternetSecurityFlag

Enable internet security flag for this P2SVpnGateway connections

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

-EnableRoutingPreferenceInternetFlag

Flag to enable Routing Preference Internet on this P2SVpnGateway.

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

-Name

The resource name.

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

-P2SConnectionConfiguration

The list of P2SConnectionConfigurations that this P2SVpnGateway needs to have.

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

-ResourceGroupName

The resource name.

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

-RoutingConfiguration

Routing configuration for this connection

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

-Tag

A hashtable which represents resource tags.

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

-VirtualHub

The VirtualHub this P2SVpnGateway needs to be associated with.

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

-VirtualHubId

The Id of the VirtualHub this P2SVpnGateway needs to be associated with.

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

-VirtualHubName

The Id of the VirtualHub this P2SVpnGateway needs to be associated with.

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

-VpnClientAddressPool

P2S VpnClient AddressPool for this P2SVpnGateway P2SConnectionConfiguration.

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

-VpnGatewayScaleUnit

The scale unit for this P2SVpnGateway.

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

-VpnServerConfiguration

The VpnServerConfiguration to be attached to this P2SVpnGateway.

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

-VpnServerConfigurationId

The id of Vpn server configuration object this P2SVpnGateway will be attached to.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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

Inputs

PSVirtualHub

System.String Microsoft.Azure.Commands.Network.Models.PSVpnServerConfiguration

Outputs

PSP2SVpnGateway