Partager via

New-AzVirtualNetwork

  • Référence
Module:
Az.Network

Crée un réseau virtuel.

Syntaxe

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

La cmdlet New-AzVirtualNetwork crée un réseau virtuel Azure.

Exemples

Exemple 1 : Créer un réseau virtuel avec deux sous-réseaux

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

Cet exemple crée un réseau virtuel avec deux sous-réseaux. Tout d’abord, un nouveau groupe de ressources est créé dans la région centralus. Ensuite, l’exemple crée des représentations en mémoire de deux sous-réseaux. L’applet de commande New-AzVirtualNetworkSubnetConfig ne crée aucun sous-réseau côté serveur. Il existe un sous-réseau appelé frontendSubnet et un sous-réseau appelé backendSubnet. L’applet de commande New-AzVirtualNetwork crée ensuite un réseau virtuel à l’aide du CIDR 10.0.0.0/16 comme préfixe d’adresse et deux sous-réseaux.

Exemple 2 : Créer un réseau virtuel avec des paramètres 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

Cet exemple crée un réseau virtuel avec deux sous-réseaux et deux serveurs DNS. L’effet de la spécification des serveurs DNS sur le réseau virtuel est que les cartes réseau/machines virtuelles déployées dans ce réseau virtuel héritent de ces serveurs DNS par défaut. Ces valeurs par défaut peuvent être remplacées par carte réseau via un paramètre au niveau de la carte réseau. Si aucun serveur DNS n’est spécifié sur un réseau virtuel et aucun serveur DNS sur les cartes réseau, les serveurs Azure DNS par défaut sont utilisés pour la résolution DNS.

Exemple 3 : Créer un réseau virtuel avec un sous-réseau faisant référence à un groupe de sécurité réseau

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

Cet exemple crée un réseau virtuel avec des sous-réseaux qui font référence à un groupe de sécurité réseau. Tout d’abord, l’exemple crée un groupe de ressources en tant que conteneur pour les ressources qui seront créées. Ensuite, un groupe de sécurité réseau est créé qui autorise l’accès RDP entrant, mais applique les règles de groupe de sécurité réseau par défaut. L’applet de commande New-AzVirtualNetworkSubnetConfig crée ensuite des représentations en mémoire de deux sous-réseaux qui font référence au groupe de sécurité réseau créé. La commande New-AzVirtualNetwork crée ensuite le réseau virtuel.

Exemple 4 : Créer un réseau virtuel avec un pool IPAM à allouer automatiquement à partir des préfixes d’adresse

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

Cet exemple crée un réseau virtuel avec un pool IPAM (Gestion des adresses IP) pour allouer automatiquement des préfixes d’adresses. Tout d’abord, un pool IPAM nommé testIpamPool est créé dans le groupe de ressources testRG et le gestionnaire de réseau testNM dans la région centralus avec le préfixe d’adresse 10.0.0.0/16. L’applet de commande Get-AzNetworkManagerIpamPool récupère le pool IPAM qui vient d’être créé. Ensuite, un objet personnalisé représentant l’allocation de préfixes du pool IPAM est créé. Cet objet inclut l’ID du pool IPAM et numberOfIpAddresses à allouer. L’applet de commande New-AzVirtualNetworkSubnetConfig crée un sous-réseau nommé testSubnet configuré pour utiliser l’objet d’allocation de préfixe du pool IPAM. Enfin, l’applet de commande New-AzVirtualNetwork crée un réseau virtuel nommé testVnet dans le groupe de ressources testRG et l’emplacement centralus. Le réseau virtuel inclut le sous-réseau créé à l’étape précédente et utilise l’allocation de préfixe du pool IPAM pour l’allocation de préfixe d’adresse.

Paramètres

-AddressPrefix

Spécifie une plage d’adresses IP pour un réseau virtuel.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-AsJob

Exécuter l’applet de commande en arrière-plan

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-BgpCommunity

La communauté BGP a été annoncée sur ExpressRoute.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DdosProtectionPlanId

Référence à la ressource de plan de protection DDoS associée au réseau virtuel.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DnsServer

Spécifie le serveur DNS pour un sous-réseau.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-EdgeZone

{{ Fill EdgeZone Description }}

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-EnableDdosProtection

Paramètre de commutateur qui représente si la protection DDoS est activée ou non.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableEncryption

Indique si le chiffrement est activé sur le réseau virtuel. La valeur doit être true pour activer le chiffrement sur le réseau virtuel, false pour désactiver le chiffrement.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-EncryptionEnforcementPolicy

Définissez Encryption EnforcementPolicy. La valeur doit être allowUnencrypted pour autoriser les machines virtuelles sans fonctionnalité de chiffrement à l’intérieur d’un réseau virtuel chiffré, ou dropUnencrypted pour désactiver toute machine virtuelle sans fonctionnalité de chiffrement d’être ajoutée à un réseau virtuel chiffré.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-FlowTimeout

FlowTimeout active le suivi des connexions pour les flux intra-machine virtuelle. La valeur doit être comprise entre 4 et 30 minutes (inclusive) pour activer le suivi, ou null pour désactiver le suivi.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IpAllocation

Spécifie IpAllocations pour un réseau virtuel.

Type:PSIpAllocation[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-IpamPoolPrefixAllocation

Spécifie une liste d’objets PSIpamPoolPrefixAllocation à allouer automatiquement à partir des préfixes d’adresses de réseau virtuel.

Type:PSIpamPoolPrefixAllocation[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Location

Spécifie la région du réseau virtuel.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie le nom du réseau virtuel créé par cette applet de commande.

Type:String
Alias:ResourceName
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PrivateEndpointVNetPoliciesValue

PrivateEndpointVNetPolicies du réseau virtuel

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceGroupName

Spécifie le nom d’un groupe de ressources pour contenir le réseau virtuel.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Subnet

Spécifie une liste de sous-réseaux à associer au réseau virtuel.

Type:PSSubnet[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Tag

Paires clé-valeur sous la forme d’une table de hachage. Par exemple : @{key0="value0 » ; key1=$null ; key2="value2"}

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

String[]

PSSubnet[]

Hashtable

Sorties

PSVirtualNetwork