Condividi tramite


New-AzVirtualNetwork

Crea una rete virtuale.

Sintassi

Default (impostazione predefinita).

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.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-AsJob

Eseguire il cmdlet in background

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-BgpCommunity

La community BGP annunciata tramite ExpressRoute.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DdosProtectionPlanId

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-DefaultProfile

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

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DnsServer

Specifica il server DNS per una subnet.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-EdgeZone

{{ Fill EdgeZone Description }}

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-EnableDdosProtection

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:

Nullable<T>[Int32]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Force

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IpAllocation

Specifica IpAllocations per una rete virtuale.

Proprietà dei parametri

Tipo:

PSIpAllocation[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-IpamPoolPrefixAllocation

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

Proprietà dei parametri

Tipo:

PSIpamPoolPrefixAllocation[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Location

Specifica l'area per la rete virtuale.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome della rete virtuale creata da questo cmdlet.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ResourceName

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-PrivateEndpointVNetPoliciesValue

PrivateEndpointVNetPolicies della rete virtuale

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ResourceGroupName

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Subnet

Specifica un elenco di subnet da associare alla rete virtuale.

Proprietà dei parametri

Tipo:

PSSubnet[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Tag

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

Proprietà dei parametri

Tipo:Hashtable
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

String

PSSubnet

Hashtable

Output

PSVirtualNetwork