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.

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

-AsJob

Cmdlet im Hintergrund ausführen

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

-BgpCommunity

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

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

-Confirm

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

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

-DdosProtectionPlanId

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

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

-DefaultProfile

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

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

-DnsServer

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

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

-EdgeZone

{{ Fill EdgeZone Description }}

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

-EnableDdosProtection

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-IpAllocation

Gibt IpAllocations für ein virtuelles Netzwerk an.

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

-Location

Gibt die Region für das virtuelle Netzwerk an.

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

-Name

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

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

-ResourceGroupName

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

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

-Subnet

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

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

-Tag

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

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

-WhatIf

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

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

Eingaben

String

String[]

PSSubnet[]

Hashtable

Ausgaben

PSVirtualNetwork