Condividi tramite

New-AzVirtualNetwork

  • Riferimento
Modulo:
Az.Network

Crea una rete virtuale.

Sintassi

New-AzVirtualNetwork
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -AddressPrefix <String[]>
   [-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. Quando si specificano i server DNS nella rete virtuale, le schede di interfaccia di rete e le macchine virtuali distribuite nella rete virtuale ereditano i server DNS come 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.

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 all'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

-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 gli effetti dell'esecuzione del cmdlet. 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