Freigeben über


New-AzVirtualNetwork

Erstellen Sie ein virtuelles Netzwerk.

Syntax

Default (Standardwert)

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.

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:True
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

-BgpCommunity

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

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:True
Wert aus verbleibenden Argumenten:False

-Confirm

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
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

-DdosProtectionPlanId

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

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:True
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

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

-DnsServer

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

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:True
Wert aus verbleibenden Argumenten:False

-EdgeZone

{{ Fill EdgeZone Description }}

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:True
Wert aus verbleibenden Argumenten:False

-EnableDdosProtection

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
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

-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.

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:True
Wert aus verbleibenden Argumenten: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.

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:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

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:True
Wert aus verbleibenden Argumenten:False

-Force

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

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

-IpAllocation

Gibt IpAllocations für ein virtuelles Netzwerk an.

Parametereigenschaften

Typ:

PSIpAllocation[]

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:True
Wert aus verbleibenden Argumenten:False

-IpamPoolPrefixAllocation

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

Parametereigenschaften

Typ:

PSIpamPoolPrefixAllocation[]

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:True
Wert aus verbleibenden Argumenten:False

-Location

Gibt die Region für das virtuelle Netzwerk an.

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:True
Wert aus verbleibenden Argumenten:False

-Name

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

Parametereigenschaften

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

Parametersätze

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

-PrivateEndpointVNetPoliciesValue

PrivateEndpointVNetPolicies 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:True
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

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

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:True
Wert aus verbleibenden Argumenten:False

-Subnet

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

Parametereigenschaften

Typ:

PSSubnet[]

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:True
Wert aus verbleibenden Argumenten:False

-Tag

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

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:True
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:False
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

String

String

PSSubnet

Hashtable

Ausgaben

PSVirtualNetwork