New-AzVirtualNetwork

Modul:

Az.Network Module

Vytvoří virtuální síť.

Syntax

Default (Výchozí)

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

Rutina New-AzVirtualNetwork vytvoří virtuální síť Azure.

Příklady

Příklad 1: Vytvoření virtuální sítě se dvěma podsítěmi

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

Tento příklad vytvoří virtuální síť se dvěma podsítěmi. Nejprve se vytvoří nová skupina prostředků v oblasti centralus. Pak příklad vytvoří reprezentaci dvou podsítí v paměti. Rutina New-AzVirtualNetworkSubnetConfig na straně serveru nevytvoří žádnou podsíť. Existuje jedna podsíť s názvem frontendSubnet a jedna podsíť s názvem backendSubnet. Rutina New-AzVirtualNetwork pak vytvoří virtuální síť pomocí CIDR 10.0.0.0/16 jako předpony adresy a dvou podsítí.

Příklad 2: Vytvoření virtuální sítě s nastavením DNS

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

Tento příklad vytvoří virtuální síť se dvěma podsítěmi a dvěma servery DNS. Účinek určení serverů DNS ve virtuální síti spočívá v tom, že síťové karty nebo virtuální počítače nasazené do této virtuální sítě dědí tyto servery DNS jako výchozí hodnoty. Tato výchozí nastavení se dají přepsat na síťovou kartu prostřednictvím nastavení na úrovni síťové karty. Pokud ve virtuální síti nejsou zadané žádné servery DNS a na síťových kartách nejsou žádné servery DNS, použijí se výchozí servery Azure DNS pro překlad DNS.

Příklad 3: Vytvoření virtuální sítě s podsítí odkazující na skupinu zabezpečení sítě

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

Tento příklad vytvoří virtuální síť s podsítěmi, které odkazují na skupinu zabezpečení sítě. Nejprve příklad vytvoří skupinu prostředků jako kontejner pro prostředky, které se vytvoří. Pak se vytvoří skupina zabezpečení sítě, která povoluje příchozí přístup RDP, ale jinak vynucuje výchozí pravidla skupiny zabezpečení sítě. Rutina New-AzVirtualNetworkSubnetConfig pak vytvoří reprezentaci dvou podsítí v paměti, které odkazují na skupinu zabezpečení sítě, která byla vytvořena. Příkaz New-AzVirtualNetwork pak vytvoří virtuální síť.

Příklad 4: Vytvoření virtuální sítě s fondem IPAM pro automatické přidělování předpon adres

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

Tento příklad vytvoří virtuální síť s fondem IPAM (SPRÁVA IP adres), který automaticky přidělí předpony adres. Nejprve se vytvoří fond IPAM s názvem testIpamPool ve skupině prostředků testRG a správce sítě testNM v centrální oblasti s předponou adresy 10.0.0.0/16. Rutina Get-AzNetworkManagerIpamPool načte fond IPAM, který byl právě vytvořen. Dále se vytvoří vlastní objekt představující přidělení předpony fondu IPAM. Tento objekt zahrnuje ID fondu IPAM a NumberOfIpAddresses, které se mají přidělit. Rutina New-AzVirtualNetworkSubnetConfig vytvoří podsíť s názvem testSubnet nakonfigurovanou tak, aby používala objekt přidělování předpon fondu IPAM. Nakonec rutina New-AzVirtualNetwork vytvoří virtuální síť s názvem testVnet ve skupině prostředků testRG a umístění centralus. Virtuální síť zahrnuje podsíť vytvořenou v předchozím kroku a používá přidělení předpony fondu IPAM pro přidělování předpon adres.

Parametry

-AddressPrefix

Určuje rozsah IP adres pro virtuální síť.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-AsJob

Spuštění rutiny na pozadí

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-BgpCommunity

Komunita protokolu BGP inzerovaná přes ExpressRoute.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DdosProtectionPlanId

Odkaz na prostředek plánu ochrany před útoky DDoS přidružený k virtuální síti

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Vlastnosti parametru

Typ:	IAzureContextContainer
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DnsServer

Určuje server DNS pro podsíť.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-EdgeZone

{{ Fill EdgeZone Description }}

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-EnableDdosProtection

Parametr přepínače, který představuje, jestli je povolená ochrana před útoky DDoS nebo ne.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-EnableEncryption

Označuje, jestli je ve virtuální síti povolené šifrování. Hodnota by měla být pravdivá, pokud chcete povolit šifrování ve virtuální síti, nepravda pro zakázání šifrování.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-EncryptionEnforcementPolicy

Nastavte zásadu vynucení šifrování. Hodnota by měla být povolena, aby se virtuální počítače povolovaly bez možnosti šifrování v šifrované virtuální síti, nebo dropUnencrypted zakázat jakýkoli virtuální počítač bez možnosti šifrování, aby se přidaly do šifrované virtuální sítě.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-FlowTimeout

FlowTimeout umožňuje sledování připojení pro toky uvnitř virtuálního počítače. Hodnota by měla být mezi 4 a 30 minut (včetně), aby bylo možné sledování povolit nebo zakázat sledování hodnotou null.

Vlastnosti parametru

Typ:	Nullable<T>[Int32]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-IpAllocation

Určuje IpAllocations pro virtuální síť.

Vlastnosti parametru

Typ:	PSIpAllocation[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-IpamPoolPrefixAllocation

Určuje seznam objektů PSIpamPoolPrefixAllocation pro automatické přidělení pro předpony adres virtuální sítě.

Vlastnosti parametru

Typ:	PSIpamPoolPrefixAllocation[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Location

Určuje oblast pro virtuální síť.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Name

Určuje název virtuální sítě, kterou tato rutina vytvoří.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Název zdroje

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-PrivateEndpointVNetPoliciesValue

PrivateEndpointVNetPolicies virtuální sítě

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ResourceGroupName

Určuje název skupiny prostředků, která bude obsahovat virtuální síť.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Subnet

Určuje seznam podsítí, které se mají přidružit k virtuální síti.

Vlastnosti parametru

Typ:	PSSubnet[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Tag

Páry klíč-hodnota ve formě tabulky hash. Příklad: @{key0="value0"; key1=$null; key2="value2"}

Vlastnosti parametru

Typ:	Hashtable
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

String

PSSubnet

Hashtable

Výstupy

PSVirtualNetwork

Související odkazy

• Get-AzVirtualNetwork
• Remove-AzVirtualNetwork
• Set-AzVirtualNetwork
• New-AzDdosProtectionPlan