Condividi tramite


New-AzVirtualNetwork

Crea una rete virtuale.

Sintassi

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

Descrizione

Il cmdlet New-AzVirtualNetwork crea una rete virtuale di Azure.

Esempio

Esempio 1: Creare una rete virtuale con due subnet

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

Questo esempio crea una rete virtuale con due subnet. Prima di tutto, viene creato un nuovo gruppo di risorse nell'area centralus. L'esempio crea quindi rappresentazioni in memoria di due subnet. Il cmdlet New-AzVirtualNetworkSubnetConfig non creerà alcuna subnet sul lato server. Esiste una subnet denominata frontendSubnet e una subnet denominata backendSubnet. Il cmdlet New-AzVirtualNetwork crea quindi una rete virtuale usando CIDR 10.0.0.0/16 come prefisso dell'indirizzo e due subnet.

Esempio 2: Creare una rete virtuale con le impostazioni 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

Questo esempio crea una rete virtuale con due subnet e due server DNS. L'effetto di specificare i server DNS nella rete virtuale è che le schede di interfaccia di rete/macchine virtuali distribuite in questa rete virtuale ereditano questi server DNS come valori predefiniti. Queste impostazioni predefinite possono essere sovrascritte per scheda di interfaccia di rete tramite un'impostazione a livello di scheda di interfaccia di rete. Se non vengono specificati server DNS in una rete virtuale e nessun server DNS nelle schede di interfaccia di rete, i server DNS di Azure predefiniti vengono usati per la risoluzione DNS.

Esempio 3: Creare una rete virtuale con una subnet che fa riferimento a un gruppo di sicurezza di rete

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

Questo esempio crea una rete virtuale con subnet che fanno riferimento a un gruppo di sicurezza di rete. In primo luogo, l'esempio crea un gruppo di risorse come contenitore per le risorse che verranno create. Viene quindi creato un gruppo di sicurezza di rete che consente l'accesso RDP in ingresso, ma applica in caso contrario le regole predefinite del gruppo di sicurezza di rete. Il cmdlet New-AzVirtualNetworkSubnetConfig crea quindi rappresentazioni in memoria di due subnet che fanno riferimento al gruppo di sicurezza di rete creato. Il comando New-AzVirtualNetwork crea quindi la rete virtuale.

Esempio 4: Creare una rete virtuale con un pool di Gestione indirizzi IP da cui allocare automaticamente per i prefissi degli indirizzi

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 questo esempio viene creata una rete virtuale con un pool di Gestione indirizzi IP per allocare automaticamente i prefissi degli indirizzi. Prima di tutto, viene creato un pool di Gestione indirizzi IP denominato testIpamPool nel gruppo di risorse testRG e nel gestore di rete testNM nell'area centralus con il prefisso dell'indirizzo 10.0.0.0/16. Il cmdlet Get-AzNetworkManagerIpamPool recupera il pool di Gestione indirizzi IP appena creato. Viene quindi creato un oggetto personalizzato che rappresenta l'allocazione del prefisso del pool di Gestione indirizzi IP. Questo oggetto include l'ID del pool di Gestione indirizzi IP e numberOfIpAddresses da allocare. Il cmdlet New-AzVirtualNetworkSubnetConfig crea una subnet denominata testSubnet configurata per l'uso dell'oggetto di allocazione del prefisso del pool di Gestione indirizzi IP. Infine, il cmdlet New-AzVirtualNetwork crea una rete virtuale denominata testVnet nel gruppo di risorse testRG e nella posizione centrale. La rete virtuale include la subnet creata nel passaggio precedente e usa l'allocazione del prefisso del pool di Gestione indirizzi IP per l'allocazione del prefisso degli indirizzi.

Parametri

-AddressPrefix

Specifica un intervallo di indirizzi IP per una rete virtuale.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-AsJob

Eseguire il cmdlet in background

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BgpCommunity

La community BGP annunciata tramite ExpressRoute.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DdosProtectionPlanId

Riferimento alla risorsa del piano di protezione DDoS associata alla rete virtuale.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DnsServer

Specifica il server DNS per una subnet.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-EdgeZone

{{ Fill EdgeZone Description }}

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-EnableDdosProtection

Parametro switch che rappresenta se la protezione DDoS è abilitata o meno.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableEncryption

Indica se la crittografia è abilitata nella rete virtuale. Il valore deve essere true per abilitare la crittografia nella rete virtuale, false per disabilitare la crittografia.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-EncryptionEnforcementPolicy

Impostare Encryption EnforcementPolicy. Il valore deve essere allowUnencrypted per consentire alle macchine virtuali senza funzionalità di crittografia all'interno di una rete virtuale crittografata o dropUnencrypted per disabilitare qualsiasi macchina virtuale senza funzionalità di crittografia da aggiungere in una rete virtuale crittografata.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-FlowTimeout

FlowTimeout abilita il rilevamento delle connessioni per i flussi all'interno della macchina virtuale. Il valore deve essere compreso tra 4 e 30 minuti (inclusi) per abilitare il rilevamento o null per disabilitare il rilevamento.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Force

Forza l'esecuzione del comando senza chiedere conferma dell'utente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IpAllocation

Specifica IpAllocations per una rete virtuale.

Tipo:PSIpAllocation[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-IpamPoolPrefixAllocation

Specifica un elenco di oggetti PSIpamPoolPrefixAllocation da cui allocare automaticamente per i prefissi degli indirizzi di rete virtuale.

Tipo:Microsoft.Azure.Commands.Network.Models.PSIpamPoolPrefixAllocation[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Location

Specifica l'area per la rete virtuale.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome della rete virtuale creata da questo cmdlet.

Tipo:String
Alias:ResourceName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PrivateEndpointVNetPoliciesValue

PrivateEndpointVNetPolicies della rete virtuale

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceGroupName

Specifica il nome di un gruppo di risorse che deve contenere la rete virtuale.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Subnet

Specifica un elenco di subnet da associare alla rete virtuale.

Tipo:PSSubnet[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Tag

Coppie chiave-valore sotto forma di tabella hash. Ad esempio: @{key0="value0"; key1=$null; key2="value2"}

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

String[]

PSSubnet[]

Hashtable

Output

PSVirtualNetwork