New-AzVirtualNetwork

Module:

Az.Network Module

Créer un réseau virtuel.

Syntaxe

Default (Par défaut)

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

L’applet de commande 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.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-AsJob

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

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-BgpCommunity

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

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-Confirm

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

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	cf

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DdosProtectionPlanId

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

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-DefaultProfile

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

Propriétés du paramètre

Type:	IAzureContextContainer
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DnsServer

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

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-EdgeZone

{{ Fill EdgeZone Description }}

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-EnableDdosProtection

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

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	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é.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	Nullable<T>[Int32]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-Force

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

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-IpAllocation

Spécifie IpAllocations pour un réseau virtuel.

Propriétés du paramètre

Type:	PSIpAllocation[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-IpamPoolPrefixAllocation

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

Propriétés du paramètre

Type:	PSIpamPoolPrefixAllocation[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-Location

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

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-Name

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

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	ResourceName

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-PrivateEndpointVNetPoliciesValue

PrivateEndpointVNetPolicies du réseau virtuel

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-ResourceGroupName

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

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-Subnet

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

Propriétés du paramètre

Type:	PSSubnet[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-Tag

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

Propriétés du paramètre

Type:	Hashtable
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Wi

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

String

PSSubnet

Hashtable

Sorties

PSVirtualNetwork

Liens associés

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