Megosztás:

New-AzVirtualNetwork

Modul:
Az.Network Module

Virtuális hálózatot hoz létre.

Szintaxis

Default (Alapértelmezett) 

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

Leírás

A New-AzVirtualNetwork parancsmag létrehoz egy Azure-beli virtuális hálózatot.

Példák

1. példa: Virtuális hálózat létrehozása két alhálózattal

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

Ez a példa létrehoz egy két alhálózattal rendelkező virtuális hálózatot. Először egy új erőforráscsoport jön létre a centralus régióban. Ezután a példa két alhálózat memórián belüli ábrázolását hozza létre. A New-AzVirtualNetworkSubnetConfig parancsmag nem hoz létre alhálózatot a kiszolgálóoldalon. Van egy frontendSubnet nevű alhálózat és egy backendSubnet nevű alhálózat. A New-AzVirtualNetwork parancsmag ezután létrehoz egy virtuális hálózatot a CIDR 10.0.0.0/16 címelőtagként és két alhálózattal.

2. példa: Virtuális hálózat létrehozása DNS-beállításokkal

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

Ez a példa két alhálózattal és két DNS-kiszolgálóval rendelkező virtuális hálózatot hoz létre. A DNS-kiszolgálók virtuális hálózaton való megadásának az a hatása, hogy a virtuális hálózaton üzembe helyezett hálózati adapterek/virtuális gépek alapértelmezés szerint öröklik ezeket a DNS-kiszolgálókat. Ezek az alapértelmezett értékek felülírhatók hálózati adapterenként egy hálózati adapterszintű beállítással. Ha nincs megadva DNS-kiszolgáló egy virtuális hálózaton, és a hálózati adaptereken nincs DNS-kiszolgáló, akkor a rendszer az alapértelmezett Azure DNS-kiszolgálókat használja a DNS-feloldáshoz.

3. példa: Virtuális hálózat létrehozása egy hálózati biztonsági csoportra hivatkozó alhálózattal

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

Ez a példa egy hálózati biztonsági csoportra hivatkozó alhálózatokkal rendelkező virtuális hálózatot hoz létre. Először is a példa létrehoz egy erőforráscsoportot tárolóként a létrehozandó erőforrásokhoz. Ezután létrejön egy hálózati biztonsági csoport, amely engedélyezi a bejövő RDP-hozzáférést, de máskülönben kikényszeríti az alapértelmezett hálózati biztonsági csoportszabályokat. A New-AzVirtualNetworkSubnetConfig parancsmag ezután két alhálózat memórián belüli ábrázolását hozza létre, amelyek mindkettő a létrehozott hálózati biztonsági csoportra hivatkoznak. A New-AzVirtualNetwork parancs ezután létrehozza a virtuális hálózatot.

4. példa: IpAM-készlettel rendelkező virtuális hálózat létrehozása a címelőtagok automatikus lefoglalásához

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

Ez a példa létrehoz egy IPAM (IP Address Management) készlettel rendelkező virtuális hálózatot a címelőtagok automatikus lefoglalásához. Először egy testIpamPool nevű IPAM-készlet jön létre a testRG erőforráscsoportban és a testNM hálózatkezelőben a centralus régióban a 10.0.0.0/16 címelőtaggal. A Get-AzNetworkManagerIpamPool parancsmag lekéri az imént létrehozott IPAM-készletet. Ezután létrejön egy egyéni objektum, amely az IPAM-készlet előtag-lefoglalását jelöli. Ez az objektum tartalmazza az IPAM-készlet azonosítóját és a lefoglalni kívánt NumberOfIpAddresses azonosítót. A New-AzVirtualNetworkSubnetConfig parancsmag létrehoz egy testSubnet nevű alhálózatot, amely az IPAM-készlet előtag-foglalási objektumának használatára van konfigurálva. Végül a New-AzVirtualNetwork parancsmag létrehoz egy testVnet nevű virtuális hálózatot a testRG erőforráscsoportban és a centralus helyén. A virtuális hálózat tartalmazza az előző lépésben létrehozott alhálózatot, és az IPAM-készlet előtag-lefoglalását használja a címelőtagok lefoglalásához.

Paraméterek

-AddressPrefix

Egy virtuális hálózat IP-címtartományát adja meg.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-AsJob

Parancsmag futtatása a háttérben

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:False
Érték a maradék argumentumokból:False

-BgpCommunity

A BGP-közösség az ExpressRoute-on hirdetett.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogató vadkártyák:False
Don't Show:False
Aliasok:Cf

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:False
Érték a maradék argumentumokból:False

-DdosProtectionPlanId

Hivatkozás a virtuális hálózathoz társított DDoS védelmi terv erőforrására.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Paramétertulajdonságok

Típus:IAzureContextContainer
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False
Aliasok:AzContext, AzureRmContext, AzureCredential

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:False
Érték a maradék argumentumokból:False

-DnsServer

Egy alhálózat DNS-kiszolgálójának megadása.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-EdgeZone

{{ Fill EdgeZone Description }}

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-EnableDdosProtection

Kapcsolóparaméter, amely azt jelzi, hogy engedélyezve van-e a DDoS-védelem.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:False
Érték a maradék argumentumokból:False

-EnableEncryption

Azt jelzi, hogy engedélyezve van-e a titkosítás a virtuális hálózaton. Az értéknek igaznak kell lennie ahhoz, hogy engedélyezze a titkosítást a virtuális hálózaton, hamisnak kell lennie a titkosítás letiltásához.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-EncryptionEnforcementPolicy

Állítsa be a Encryption EnforcementPolicy parancsot. Az értéknek engedélyeznie kell, hogy a titkosított virtuális hálózaton belüli titkosítási képesség nélküli virtuális gépek, vagy a dropUnencrypted letiltsa a titkosítási képesség nélküli virtuális gépeket a titkosított virtuális hálózathoz való hozzáadástól.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-FlowTimeout

A FlowTimeout lehetővé teszi a kapcsolat nyomon követését a virtuális gépeken belüli folyamatokhoz. Az értéknek 4 és 30 perc közöttinek kell lennie (beleértve) a nyomon követés engedélyezéséhez, vagy null értéknek kell lennie a nyomon követés letiltásához.

Paramétertulajdonságok

Típus:

Nullable<T>[Int32]

Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-Force

Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:False
Érték a maradék argumentumokból:False

-IpAllocation

IpAllocations értékeket ad meg egy virtuális hálózathoz.

Paramétertulajdonságok

Típus:

PSIpAllocation[]

Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-IpamPoolPrefixAllocation

Megadja azoknak a PSIpamPoolPrefixAllocation objektumoknak a listáját, amelyből automatikusan lefoglalhatók a virtuális hálózati címelőtagok.

Paramétertulajdonságok

Típus:

PSIpamPoolPrefixAllocation[]

Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-Location

Megadja a virtuális hálózat régióját.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-Name

Megadja a parancsmag által létrehozott virtuális hálózat nevét.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False
Aliasok:ResourceName

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-PrivateEndpointVNetPoliciesValue

A virtuális hálózat PrivateEndpointVNetPolicies tulajdonsága

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-ResourceGroupName

Megadja a virtuális hálózatot tartalmazó erőforráscsoport nevét.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-Subnet

Megadja a virtuális hálózathoz társítandó alhálózatok listáját.

Paramétertulajdonságok

Típus:

PSSubnet[]

Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-Tag

Kulcs-érték párok kivonattábla formájában. Például: @{key0="value0"; key1=$null; key2="value2"}

Paramétertulajdonságok

Típus:Hashtable
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogató vadkártyák:False
Don't Show:False
Aliasok:Wi

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:False
Érték a maradék argumentumokból:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bemenetek

String

String

PSSubnet

Hashtable

Kimenetek

PSVirtualNetwork