Freigeben über

New-AzVirtualNetwork

  • Referenz
Modul:
Az.Network

Erstellt ein virtuelles Netzwerk.

Syntax

New-AzVirtualNetwork
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -AddressPrefix <String[]>
   [-IpamPoolPrefixAllocation <PSIpamPoolPrefixAllocation[]>]
   [-DnsServer <String[]>]
   [-FlowTimeout <Int32>]
   [-Subnet <PSSubnet[]>]
   [-BgpCommunity <String>]
   [-EnableEncryption <String>]
   [-EncryptionEnforcementPolicy <String>]
   [-Tag <Hashtable>]
   [-EnableDdosProtection]
   [-DdosProtectionPlanId <String>]
   [-IpAllocation <PSIpAllocation[]>]
   [-EdgeZone <String>]
   [-PrivateEndpointVNetPoliciesValue <String>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzVirtualNetwork erstellt ein virtuelles Azure-Netzwerk.

Beispiele

Beispiel 1: Erstellen eines virtuellen Netzwerks mit zwei Subnetzen

New-AzResourceGroup -Name TestResourceGroup -Location centralus
$frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name frontendSubnet -AddressPrefix "10.0.1.0/24"
$backendSubnet  = New-AzVirtualNetworkSubnetConfig -Name backendSubnet  -AddressPrefix "10.0.2.0/24"
New-AzVirtualNetwork -Name MyVirtualNetwork -ResourceGroupName TestResourceGroup -Location centralus -AddressPrefix "10.0.0.0/16" -Subnet $frontendSubnet,$backendSubnet

In diesem Beispiel wird ein virtuelles Netzwerk mit zwei Subnetzen erstellt. Zunächst wird eine neue Ressourcengruppe in der zentralen Region erstellt. Anschließend erstellt das Beispiel speicherinterne Darstellungen von zwei Subnetzen. Das Cmdlet New-AzVirtualNetworkSubnetConfig erstellt kein Subnetz auf serverseitiger Seite. Es gibt ein Subnetz namens "frontendSubnet" und ein Subnetz mit dem Namen "backendSubnet". Das Cmdlet New-AzVirtualNetwork erstellt dann ein virtuelles Netzwerk mit dem CIDR 10.0.0.0.0/16 als Adresspräfix und zwei Subnetze.

Beispiel 2: Erstellen eines virtuellen Netzwerks mit DNS-Einstellungen

New-AzResourceGroup -Name TestResourceGroup -Location centralus
$frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name frontendSubnet -AddressPrefix "10.0.1.0/24"
$backendSubnet  = New-AzVirtualNetworkSubnetConfig -Name backendSubnet  -AddressPrefix "10.0.2.0/24"
New-AzVirtualNetwork -Name MyVirtualNetwork -ResourceGroupName TestResourceGroup -Location centralus -AddressPrefix "10.0.0.0/16" -Subnet $frontendSubnet,$backendSubnet -DnsServer 10.0.1.5,10.0.1.6

In diesem Beispiel wird ein virtuelles Netzwerk mit zwei Subnetzen und zwei DNS-Servern erstellt. Der Effekt der Angabe der DNS-Server im virtuellen Netzwerk besteht darin, dass die in diesem virtuellen Netzwerk bereitgestellten NICs/VMs diese DNS-Server als Standard erben. Diese Standardwerte können pro NIC über eine Einstellung auf NIC-Ebene überschrieben werden. Wenn keine DNS-Server auf einem VNET und keine DNS-Server auf den NICs angegeben werden, werden die Standardmäßigen Azure DNS-Server für die DNS-Auflösung verwendet.

Beispiel 3: Erstellen eines virtuellen Netzwerks mit einem Subnetz, das auf eine Netzwerksicherheitsgruppe verweist

New-AzResourceGroup -Name TestResourceGroup -Location centralus
$rdpRule              = New-AzNetworkSecurityRuleConfig -Name rdp-rule -Description "Allow RDP" -Access Allow -Protocol Tcp -Direction Inbound -Priority 100 -SourceAddressPrefix Internet -SourcePortRange * -DestinationAddressPrefix * -DestinationPortRange 3389
$networkSecurityGroup = New-AzNetworkSecurityGroup -ResourceGroupName TestResourceGroup -Location centralus -Name "NSG-FrontEnd" -SecurityRules $rdpRule
$frontendSubnet       = New-AzVirtualNetworkSubnetConfig -Name frontendSubnet -AddressPrefix "10.0.1.0/24" -NetworkSecurityGroup $networkSecurityGroup
$backendSubnet        = New-AzVirtualNetworkSubnetConfig -Name backendSubnet  -AddressPrefix "10.0.2.0/24" -NetworkSecurityGroup $networkSecurityGroup
New-AzVirtualNetwork -Name MyVirtualNetwork -ResourceGroupName TestResourceGroup -Location centralus -AddressPrefix "10.0.0.0/16" -Subnet $frontendSubnet,$backendSubnet

In diesem Beispiel wird ein virtuelles Netzwerk mit Subnetzen erstellt, die auf eine Netzwerksicherheitsgruppe verweisen. Zunächst erstellt das Beispiel eine Ressourcengruppe als Container für die Ressourcen, die erstellt werden sollen. Anschließend wird eine Netzwerksicherheitsgruppe erstellt, die eingehenden RDP-Zugriff zulässt, andernfalls jedoch die Standardregeln für Netzwerksicherheitsgruppen erzwingt. Das Cmdlet New-AzVirtualNetworkSubnetConfig erstellt dann Speicherdarstellungen von zwei Subnetzen, die beide auf die erstellte Netzwerksicherheitsgruppe verweisen. Der Befehl New-AzVirtualNetwork erstellt dann das virtuelle Netzwerk.

Beispiel 4: Erstellen eines virtuellen Netzwerks mit einem IPAM-Pool zur automatischen Zuweisung für Adresspräfixe

New-AzNetworkManagerIpamPool -ResourceGroupName "testRG" -NetworkManagerName "testNM" -Name "testIpamPool" -Location "centralus" -AddressPrefix @("10.0.0.0/16")
$ipamPool = Get-AzNetworkManagerIpamPool -ResourceGroupName "testRG" -NetworkManagerName "testNM" -Name "testIpamPool"
$ipamPoolPrefixAllocation = [PSCustomObject]@{
     Id = $ipamPool.Id
     NumberOfIpAddresses = "256"
 }
$subnet = New-AzVirtualNetworkSubnetConfig -Name "testSubnet" -IpamPoolPrefixAllocation $ipamPoolPrefixAllocation
New-AzVirtualNetwork -Name "testVnet" -ResourceGroupName "testRG" -Location "centralus" -Subnet $subnet -IpamPoolPrefixAllocation $ipamPoolPrefixAllocation

In diesem Beispiel wird ein virtuelles Netzwerk mit einem IPAM-Pool (IP-Adressverwaltung) erstellt, um Adresspräfixe automatisch zuzuweisen. Zunächst wird ein IPAM-Pool namens "testIpamPool" in der TestRG-Ressourcengruppe und im TestNM-Netzwerk-Manager in der zentralen Region mit dem Adresspräfix 10.0.0.0/16 erstellt. Das Cmdlet Get-AzNetworkManagerIpamPool ruft den soeben erstellten IPAM-Pool ab. Als Nächstes wird ein benutzerdefiniertes Objekt erstellt, das die IPAM-Poolpräfixzuordnung darstellt. Dieses Objekt enthält die ID des IPAM-Pools und die zuzuordnenden NumberOfIpAddresses. Das Cmdlet New-AzVirtualNetworkSubnetConfig erstellt ein Subnetz mit dem Namen "testSubnet", das für die Verwendung des IPAM-Poolpräfixzuordnungsobjekts konfiguriert ist. Schließlich erstellt das Cmdlet New-AzVirtualNetwork ein virtuelles Netzwerk namens "testVnet" in der TestRG-Ressourcengruppe und dem zentralen Speicherort. Das virtuelle Netzwerk enthält das im vorherigen Schritt erstellte Subnetz und verwendet die IPAM-Poolpräfixzuordnung für die Adresspräfixzuordnung.

Parameter

-AddressPrefix

Gibt einen Bereich von IP-Adressen für ein virtuelles Netzwerk an.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-AsJob

Cmdlet im Hintergrund ausführen

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BgpCommunity

Die BGP-Community hat über ExpressRoute angekündigt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DdosProtectionPlanId

Verweisen Sie auf die DDoS-Schutzplanressource, die dem virtuellen Netzwerk zugeordnet ist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DnsServer

Gibt den DNS-Server für ein Subnetz an.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-EdgeZone

{{ Fill EdgeZone Description }}

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-EnableDdosProtection

Ein Switch-Parameter, der angibt, ob der DDoS-Schutz aktiviert ist oder nicht.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableEncryption

Gibt an, ob die Verschlüsselung im virtuellen Netzwerk aktiviert ist. Der Wert sollte "true" sein, um die Verschlüsselung im virtuellen Netzwerk zu aktivieren, um die Verschlüsselung zu deaktivieren.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-EncryptionEnforcementPolicy

Legen Sie die Verschlüsselungserzwingungsrichtlinie fest. Der Wert sollte "AllowUnencrypted" sein, um VMs ohne Verschlüsselungsfunktion in einem verschlüsselten virtuellen Netzwerk zuzulassen, oder dropUnencrypted, um jede VM ohne Verschlüsselungsfunktion zu deaktivieren, die in einem verschlüsselten virtuellen Netzwerk hinzugefügt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-FlowTimeout

FlowTimeout ermöglicht die Verbindungsnachverfolgung für intra-VM-Flüsse. Der Wert sollte zwischen 4 und 30 Minuten (einschließlich) liegen, um die Nachverfolgung zu aktivieren, oder null, um die Nachverfolgung zu deaktivieren.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IpAllocation

Gibt IpAllocations für ein virtuelles Netzwerk an.

Typ:PSIpAllocation[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-IpamPoolPrefixAllocation

Gibt eine Liste von PSIpamPoolPrefixAllocation-Objekten an, die automatisch für präfixe virtuelle Netzwerkadressen zugewiesen werden sollen.

Typ:PSIpamPoolPrefixAllocation[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Location

Gibt die Region für das virtuelle Netzwerk an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des virtuellen Netzwerks an, das dieses Cmdlet erstellt.

Typ:String
Aliase:ResourceName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PrivateEndpointVNetPoliciesValue

PrivateEndpointVNetPolicies des virtuellen Netzwerks

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt den Namen einer Ressourcengruppe an, die das virtuelle Netzwerk enthalten soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Subnet

Gibt eine Liste der Subnetze an, die dem virtuellen Netzwerk zugeordnet werden sollen.

Typ:PSSubnet[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Tag

Schlüssel-Wert-Paare in Form einer Hashtabelle. Beispiel: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

String[]

PSSubnet[]

Hashtable

Ausgaben

PSVirtualNetwork