Freigeben über

New-AzVirtualNetwork

  • Referenz
Modul:
Az.Network

Erstellen Sie ein virtuelles Netzwerk.

Syntax

New-AzVirtualNetwork
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -AddressPrefix <String[]>
   [-DnsServer <String[]>]
   [-FlowTimeout <Int32>]
   [-Subnet <PSSubnet[]>]
   [-BgpCommunity <String>]
   [-EnableEncryption <String>]
   [-EncryptionEnforcementPolicy <String>]
   [-Tag <Hashtable>]
   [-EnableDdosProtection]
   [-DdosProtectionPlanId <String>]
   [-IpAllocation <PSIpAllocation[]>]
   [-EdgeZone <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 der Serverseite. 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/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. Als Auswirkung der Angabe von DNS-Servern im virtuellen Netzwerk erben die in diesem virtuellen Netzwerk bereitgestellten NICs/VMs die DNS-Server als Standards. 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.

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

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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 Aufforderung zur Bestätigung durch den Benutzer.

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

-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

-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 geschieht, 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