Freigeben über

New-AzVpnSite

Modul:
Az.Network Module

Erstellt eine neue Azure VpnSite-Ressource. Dies ist eine RM-Darstellung von Kundenzweigen, die in Azure für S2S-Konnektivität mit einem virtuellen Cortex-Hub hochgeladen werden.

Syntax

ByVirtualWanNameByVpnSiteIpAddress (Standard) 

New-AzVpnSite
    -ResourceGroupName <String>
    -Name <String>
    -Location <String>
    -VirtualWanResourceGroupName <String>
    -VirtualWanName <String>
    -IpAddress <String>
    [-AddressSpace <String[]>]
    [-DeviceModel <String>]
    [-DeviceVendor <String>]
    [-IsSecuritySite]
    [-LinkSpeedInMbps <UInt32>]
    [-BgpAsn <UInt32>]
    [-BgpPeeringAddress <String>]
    [-BgpPeeringWeight <UInt32>]
    [-O365Policy <PSO365PolicyProperties>]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByVirtualWanNameByVpnSiteLinkObject 

New-AzVpnSite
    -ResourceGroupName <String>
    -Name <String>
    -Location <String>
    -VirtualWanResourceGroupName <String>
    -VirtualWanName <String>
    -VpnSiteLink <PSVpnSiteLink[]>
    [-AddressSpace <String[]>]
    [-DeviceModel <String>]
    [-DeviceVendor <String>]
    [-IsSecuritySite]
    [-O365Policy <PSO365PolicyProperties>]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByVirtualWanObjectByVpnSiteIpAddress 

New-AzVpnSite
    -ResourceGroupName <String>
    -Name <String>
    -Location <String>
    -VirtualWan <PSVirtualWan>
    -IpAddress <String>
    [-AddressSpace <String[]>]
    [-DeviceModel <String>]
    [-DeviceVendor <String>]
    [-IsSecuritySite]
    [-LinkSpeedInMbps <UInt32>]
    [-BgpAsn <UInt32>]
    [-BgpPeeringAddress <String>]
    [-BgpPeeringWeight <UInt32>]
    [-O365Policy <PSO365PolicyProperties>]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByVirtualWanObjectByVpnSiteLinkObject 

New-AzVpnSite
    -ResourceGroupName <String>
    -Name <String>
    -Location <String>
    -VirtualWan <PSVirtualWan>
    -VpnSiteLink <PSVpnSiteLink[]>
    [-AddressSpace <String[]>]
    [-DeviceModel <String>]
    [-DeviceVendor <String>]
    [-IsSecuritySite]
    [-O365Policy <PSO365PolicyProperties>]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByVirtualWanResourceIdByVpnSiteIpAddress 

New-AzVpnSite
    -ResourceGroupName <String>
    -Name <String>
    -Location <String>
    -VirtualWanId <String>
    -IpAddress <String>
    [-AddressSpace <String[]>]
    [-DeviceModel <String>]
    [-DeviceVendor <String>]
    [-IsSecuritySite]
    [-LinkSpeedInMbps <UInt32>]
    [-BgpAsn <UInt32>]
    [-BgpPeeringAddress <String>]
    [-BgpPeeringWeight <UInt32>]
    [-O365Policy <PSO365PolicyProperties>]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByVirtualWanResourceIdByVpnSiteLinkObject 

New-AzVpnSite
    -ResourceGroupName <String>
    -Name <String>
    -Location <String>
    -VirtualWanId <String>
    -VpnSiteLink <PSVpnSiteLink[]>
    [-AddressSpace <String[]>]
    [-DeviceModel <String>]
    [-DeviceVendor <String>]
    [-IsSecuritySite]
    [-O365Policy <PSO365PolicyProperties>]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Erstellt eine neue Azure VpnSite-Ressource. Dies ist eine RM-Darstellung von Kundenzweigen, die in Azure für S2S-Konnektivität mit einem virtuellen Cortex-Hub hochgeladen werden.

Beispiele

Beispiel 1

New-AzResourceGroup -Location "East US" -Name "nonlinkSite"
$virtualWan = New-AzVirtualWan -ResourceGroupName "nonlinkSite" -Name myVirtualWAN -Location "East US"

$vpnSiteAddressSpaces = New-Object string[] 2
$vpnSiteAddressSpaces[0] = "192.168.2.0/24"
$vpnSiteAddressSpaces[1] = "192.168.3.0/24"

New-AzVpnSite -ResourceGroupName "nonlinkSite" -Name "testVpnSite" -Location "East US" -VirtualWan $virtualWan -IpAddress "1.2.3.4" -AddressSpace $vpnSiteAddressSpaces -DeviceModel "SomeDevice" -DeviceVendor "SomeDeviceVendor" -LinkSpeedInMbps "10"

ResourceGroupName : nonlinkSite
Name              : testVpnSite
Id                : /subscriptions/{subscriptionId}/resourceGroups/nonlinkSite/providers/Microsoft.Network/vpnSites/testVpnSite
Location          : eastus2euap
IpAddress         : 1.2.3.4
VirtualWan        : /subscriptions/{subscriptionId}/resourceGroups/nonlinkSite/providers/Microsoft.Network/virtualWans/myVirtualWAN
AddressSpace      : {192.168.2.0/24, 192.168.3.0/24}
BgpSettings       :
Type              : Microsoft.Network/vpnSites
ProvisioningState : Succeeded

In der obigen Tabelle wird eine Ressourcengruppe, virtuelles WAN in Ost-USA in der Ressourcengruppe "nonlinkSite" in Azure erstellt.

Anschließend wird eine VpnSite erstellt, um einen Kundenzweig darzustellen und mit dem virtuellen WAN zu verbinden.

Anschließend kann eine IPSec-Verbindung mit dieser Verzweigung und einem VpnGateway mit dem befehl New-AzVpnConnection eingerichtet werden.

Beispiel 2

New-AzResourceGroup -Location "East US" -Name "multilink"
$virtualWan = New-AzVirtualWan -ResourceGroupName multilink -Name myVirtualWAN -Location "East US"
$vpnSiteAddressSpaces = New-Object string[] 2
$vpnSiteAddressSpaces[0] = "192.168.2.0/24"
$vpnSiteAddressSpaces[1] = "192.168.3.0/24"

$vpnSiteLink = New-AzVpnSiteLink -Name "testVpnSiteLink1" -IpAddress "15.25.35.45" -LinkProviderName "SomeTelecomProvider" -LinkSpeedInMbps "10"
$vpnSiteLink2 = New-AzVpnSiteLink -Name "testVpnSiteLink2" -IpAddress "15.25.35.55" -LinkProviderName "SomeTelecomProvider2" -LinkSpeedInMbps "100"
$vpnSite = New-AzVpnSite -ResourceGroupName "multilink" -Name "testVpnSite" -Location "East US" -VirtualWan $virtualWan -AddressSpace $vpnSiteAddressSpaces -DeviceModel "SomeDevice" -DeviceVendor "SomeDeviceVendor" -VpnSiteLink @($vpnSiteLink1, $vpnSiteLink2)

Im Obigen wird eine Ressourcengruppe, ein virtuelles WAN und eine VpnSite mit 1 VpnSiteLinks in Ost-US in der Ressourcengruppe "Multilink" in Azure erstellt.

Beispiel 3

Erstellt eine neue Azure VpnSite-Ressource. (autogenerated)

New-AzVpnSite -AddressSpace <String[]> -DeviceModel 'SomeDevice' -DeviceVendor 'SomeDeviceVendor' -IpAddress '1.2.3.4' -LinkSpeedInMbps '10' -Location 'East US' -Name 'testVpnSite' -ResourceGroupName 'multilink' -VirtualWanName <String> -VirtualWanResourceGroupName <String>

Parameter

-AddressSpace

Die Adresspräfixe des virtuellen Netzwerks.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-AsJob

Cmdlet im Hintergrund ausführen

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-BgpAsn

Der BGP ASN für diese VpnSite.

Parametereigenschaften

Typ:UInt32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByVirtualWanNameByVpnSiteIpAddress
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanObjectByVpnSiteIpAddress
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanResourceIdByVpnSiteIpAddress
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-BgpPeeringAddress

Die BGP-Peeringadresse für diese VpnSite.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByVirtualWanNameByVpnSiteIpAddress
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanObjectByVpnSiteIpAddress
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanResourceIdByVpnSiteIpAddress
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-BgpPeeringWeight

Die BGP-Peeringgewichtung für diese VpnSite.

Parametereigenschaften

Typ:UInt32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByVirtualWanNameByVpnSiteIpAddress
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanObjectByVpnSiteIpAddress
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanResourceIdByVpnSiteIpAddress
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DeviceModel

Das Gerätemodell des Remote-VPN-Geräts.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DeviceVendor

Der Geräteanbieter des Remote-VPN-Geräts.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IpAddress

Die IPAddress für diese VpnSite.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByVirtualWanNameByVpnSiteIpAddress
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanObjectByVpnSiteIpAddress
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanResourceIdByVpnSiteIpAddress
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IsSecuritySite

wenn es sich bei der VPN-Website um eine Sicherheitswebsite handelt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-LinkSpeedInMbps

Das Gerätemodell des Remote-VPN-Geräts.

Parametereigenschaften

Typ:UInt32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByVirtualWanNameByVpnSiteIpAddress
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanObjectByVpnSiteIpAddress
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanResourceIdByVpnSiteIpAddress
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Location

Der Ressourcenspeicherort.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Der Ressourcenname.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Ressourcenname, VpnSiteName

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-O365Policy

Die Office 365-Richtlinie für Datenverkehrsunterbrechungen für diese VpnSite.

Parametereigenschaften

Typ:PSO365PolicyProperties
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Der Ressourcenname.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Tag

Eine Hashtabelle, die Ressourcentags darstellt.

Parametereigenschaften

Typ:Hashtable
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VirtualWan

Der VirtuelleWan muss mit dieser VpnSite verbunden sein.

Parametereigenschaften

Typ:PSVirtualWan
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByVirtualWanObjectByVpnSiteIpAddress
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanObjectByVpnSiteLinkObject
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VirtualWanId

Die ResourceId VirtualWan muss mit dieser VpnSite verbunden sein.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByVirtualWanResourceIdByVpnSiteIpAddress
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanResourceIdByVpnSiteLinkObject
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VirtualWanName

Der Name des VirtualWan muss mit dieser VpnSite verbunden sein.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByVirtualWanNameByVpnSiteIpAddress
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanNameByVpnSiteLinkObject
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VirtualWanResourceGroupName

Der Ressourcengruppenname des VirtualWan muss mit dieser VpnSite verbunden werden.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByVirtualWanNameByVpnSiteIpAddress
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanNameByVpnSiteLinkObject
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VpnSiteLink

Die Liste der VpnSiteLinks, die diese VpnSite aufweisen.

Typ:

PSVpnSiteLink[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
ByVirtualWanNameByVpnSiteLinkObject
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanObjectByVpnSiteLinkObject
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByVirtualWanResourceIdByVpnSiteLinkObject
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Ausgaben

PSVpnSite