Dela via


New-AzVirtualNetwork

Skapar ett virtuellt nätverk.

Syntax

Default (Standard)

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

Description

Cmdleten New-AzVirtualNetwork skapar ett virtuellt Azure-nätverk.

Exempel

Exempel 1: Skapa ett virtuellt nätverk med två undernät

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

Det här exemplet skapar ett virtuellt nätverk med två undernät. Först skapas en ny resursgrupp i regionen centralus. Sedan skapar exemplet minnesintern representation av två undernät. Cmdleten New-AzVirtualNetworkSubnetConfig skapar inget undernät på serversidan. Det finns ett undernät som heter frontendSubnet och ett undernät som heter backendSubnet. Cmdleten New-AzVirtualNetwork skapar sedan ett virtuellt nätverk med CIDR 10.0.0.0/16 som adressprefix och två undernät.

Exempel 2: Skapa ett virtuellt nätverk med DNS-inställningar

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

Det här exemplet skapar ett virtuellt nätverk med två undernät och två DNS-servrar. Effekten av att ange DNS-servrarna i det virtuella nätverket är att de nätverkskort/virtuella datorer som distribueras till det virtuella nätverket ärver dessa DNS-servrar som standard. Dessa standardvärden kan skrivas över per nätverkskort via en inställning på NIC-nivå. Om inga DNS-servrar anges i ett virtuellt nätverk och inga DNS-servrar på nätverkskorten används standard-Azure DNS-servrarna för DNS-matchning.

Exempel 3: Skapa ett virtuellt nätverk med ett undernät som refererar till en nätverkssäkerhetsgrupp

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

Det här exemplet skapar ett virtuellt nätverk med undernät som refererar till en nätverkssäkerhetsgrupp. Först skapar exemplet en resursgrupp som en container för de resurser som ska skapas. Sedan skapas en nätverkssäkerhetsgrupp som tillåter inkommande RDP-åtkomst, men som i övrigt tillämpar standardreglerna för nätverkssäkerhetsgrupper. Cmdleten New-AzVirtualNetworkSubnetConfig skapar sedan minnesinterna representationer av två undernät som båda refererar till den nätverkssäkerhetsgrupp som skapades. Kommandot New-AzVirtualNetwork skapar sedan det virtuella nätverket.

Exempel 4: Skapa ett virtuellt nätverk med en IPAM-pool att automatiskt allokera från för adressprefix

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

Det här exemplet skapar ett virtuellt nätverk med en IPAM-pool (IP Address Management) för att automatiskt allokera adressprefix. Först skapas en IPAM-pool med namnet testIpamPool i testRG-resursgruppen och testNM-nätverkshanteraren i regionen centralus med adressprefixet 10.0.0.0/16. Cmdleten Get-AzNetworkManagerIpamPool hämtar DEN IPAM-pool som nyss skapades. Därefter skapas ett anpassat objekt som representerar IPAM-poolprefixallokeringen. Det här objektet innehåller ID:t för IPAM-poolen och NumberOfIpAddresses som ska allokeras. Cmdleten New-AzVirtualNetworkSubnetConfig skapar ett undernät med namnet testSubnet som konfigurerats för att använda IPAM-poolprefixallokeringsobjektet. Slutligen skapar New-AzVirtualNetwork-cmdleten ett virtuellt nätverk med namnet testVnet i testRG-resursgruppen och centralus-platsen. Det virtuella nätverket innehåller det undernät som skapades i föregående steg och använder IPAM-poolprefixallokeringen för adressprefixallokering.

Parametrar

-AddressPrefix

Anger ett intervall med IP-adresser för ett virtuellt nätverk.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-AsJob

Kör cmdlet i bakgrunden

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-BgpCommunity

BGP-communityn annonserades via ExpressRoute.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DdosProtectionPlanId

Referens till den DDoS-skyddsplanresurs som är associerad med det virtuella nätverket.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DnsServer

Anger DNS-servern för ett undernät.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-EdgeZone

{{ Fill EdgeZone-beskrivning }}

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-EnableDdosProtection

En växelparameter som representerar om DDoS-skydd är aktiverat eller inte.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-EnableEncryption

Anger om kryptering är aktiverat i det virtuella nätverket. Värdet ska vara sant för att aktivera kryptering i det virtuella nätverket, falskt för att inaktivera kryptering.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-EncryptionEnforcementPolicy

Ange Encryption EnforcementPolicy. Värdet bör vara allowUnencrypted för att tillåta virtuella datorer utan krypteringskapacitet i ett krypterat virtuellt nätverk, eller dropUnencrypted för att inaktivera alla virtuella datorer utan krypteringskapacitet från att läggas till i ett krypterat virtuellt nätverk.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-FlowTimeout

FlowTimeout möjliggör anslutningsspårning för flöden inom den virtuella datorn. Värdet ska vara mellan 4 och 30 minuter (inklusive) för att aktivera spårning eller null för att inaktivera spårning.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-IpAllocation

Anger IpAllocations för ett virtuellt nätverk.

Parameteregenskaper

Typ:

PSIpAllocation[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-IpamPoolPrefixAllocation

Anger en lista över PSIpamPoolPrefixAllocation-objekt som automatiskt allokeras från för adressprefix för virtuella nätverk.

Parameteregenskaper

Typ:

PSIpamPoolPrefixAllocation[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Location

Anger regionen för det virtuella nätverket.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

Anger namnet på det virtuella nätverk som den här cmdleten skapar.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Resursnamn

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-PrivateEndpointVNetPoliciesValue

PrivateEndpointVNetPolicies för det virtuella nätverket

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ResourceGroupName

Anger namnet på en resursgrupp som ska innehålla det virtuella nätverket.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Subnet

Anger en lista över undernät som ska associeras med det virtuella nätverket.

Parameteregenskaper

Typ:

PSSubnet[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Tag

Nyckel/värde-par i form av en hash-tabell. Exempel: @{key0="value0"; key1=$null; key2="value2"}

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

String

PSSubnet

Hashtable

Utdata

PSVirtualNetwork