Compartir a través de

New-AzVirtualNetwork

  • Referencia
Módulo:
Az.Network

Crea una red virtual.

Sintaxis

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

El cmdlet New-AzVirtualNetwork crea una red virtual de Azure.

Ejemplos

Ejemplo 1: Creación de una red virtual con dos subredes

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

En este ejemplo se crea una red virtual con dos subredes. En primer lugar, se crea un nuevo grupo de recursos en la región centralus. A continuación, el ejemplo crea representaciones en memoria de dos subredes. El cmdlet New-AzVirtualNetworkSubnetConfig no creará ninguna subred en el lado servidor. Hay una subred denominada frontendSubnet y una subred denominada backendSubnet. A continuación, el cmdlet New-AzVirtualNetwork crea una red virtual mediante CIDR 10.0.0.0/16 como prefijo de dirección y dos subredes.

Ejemplo 2: Creación de una red virtual con la configuración de 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

En este ejemplo se crea una red virtual con dos subredes y dos servidores DNS. El efecto de especificar los servidores DNS en la red virtual es que las NIC o las máquinas virtuales que se implementan en esta red virtual heredan estos servidores DNS como valores predeterminados. Estos valores predeterminados se pueden sobrescribir por NIC a través de una configuración de nivel de NIC. Si no se especifica ningún servidor DNS en una red virtual y ningún servidor DNS en las NIC, los servidores DNS de Azure predeterminados se usan para la resolución DNS.

Ejemplo 3: Creación de una red virtual con una subred que haga referencia a un grupo de seguridad de red

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

En este ejemplo se crea una red virtual con subredes que hacen referencia a un grupo de seguridad de red. En primer lugar, en el ejemplo se crea un grupo de recursos como contenedor para los recursos que se crearán. A continuación, se crea un grupo de seguridad de red que permite el acceso RDP entrante, pero, de lo contrario, aplica las reglas predeterminadas del grupo de seguridad de red. A continuación, el cmdlet New-AzVirtualNetworkSubnetConfig crea representaciones en memoria de dos subredes que hacen referencia al grupo de seguridad de red que se creó. A continuación, el comando New-AzVirtualNetwork crea la red virtual.

Ejemplo 4: Creación de una red virtual con un grupo de IPAM para asignar automáticamente los prefijos de dirección

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

En este ejemplo se crea una red virtual con un grupo de IPAM (administración de direcciones IP) para asignar automáticamente prefijos de dirección. En primer lugar, se crea un grupo de IPAM denominado testIpamPool en el grupo de recursos testRG y el administrador de red testNM de la región centralus con el prefijo de dirección 10.0.0.0/16. El cmdlet Get-AzNetworkManagerIpamPool recupera el grupo de IPAM que acaba de crear. A continuación, se crea un objeto personalizado que representa la asignación de prefijos del grupo de IPAM. Este objeto incluye el identificador del grupo de IPAM y numberOfIpAddresses que se va a asignar. El cmdlet New-AzVirtualNetworkSubnetConfig crea una subred denominada testSubnet configurada para usar el objeto de asignación de prefijos del grupo de IPAM. Por último, el cmdlet New-AzVirtualNetwork crea una red virtual denominada testVnet en el grupo de recursos testRG y la ubicación centralus. La red virtual incluye la subred creada en el paso anterior y usa la asignación de prefijos del grupo de IPAM para la asignación de prefijos de dirección.

Parámetros

-AddressPrefix

Especifica un intervalo de direcciones IP para una red virtual.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-AsJob

Ejecución del cmdlet en segundo plano

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BgpCommunity

La comunidad BGP anunciada a través de ExpressRoute.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DdosProtectionPlanId

Referencia al recurso del plan de protección contra DDoS asociado a la red virtual.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DnsServer

Especifica el servidor DNS para una subred.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-EdgeZone

{{ Fill EdgeZone Description }}

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-EnableDdosProtection

Parámetro switch que representa si la protección contra DDoS está habilitada o no.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableEncryption

Indica si el cifrado está habilitado en la red virtual. El valor debe ser true para habilitar el cifrado en la red virtual, false para deshabilitar el cifrado.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-EncryptionEnforcementPolicy

Establezca Encryption EnforcementPolicy. El valor debe ser allowUnencrypted para permitir que las máquinas virtuales sin funcionalidad de cifrado dentro de una red virtual cifrada o dropUnencrypted deshabiliten cualquier máquina virtual sin capacidad de cifrado que se agregue a una red virtual cifrada.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-FlowTimeout

FlowTimeout habilita el seguimiento de conexiones para flujos dentro de máquinas virtuales. El valor debe estar entre 4 y 30 minutos (ambos incluidos) para habilitar el seguimiento o null para deshabilitar el seguimiento.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IpAllocation

Especifica IpAllocations para una red virtual.

Tipo:PSIpAllocation[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-IpamPoolPrefixAllocation

Especifica una lista de objetos PSIpamPoolPrefixAllocation a los que asignar automáticamente los prefijos de dirección de red virtual.

Tipo:PSIpamPoolPrefixAllocation[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Location

Especifica la región de la red virtual.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica el nombre de la red virtual que crea este cmdlet.

Tipo:String
Alias:ResourceName
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PrivateEndpointVNetPoliciesValue

PrivateEndpointVNetPolicies de la red virtual

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ResourceGroupName

Especifica el nombre de un grupo de recursos que va a contener la red virtual.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Subnet

Especifica una lista de subredes que se van a asociar a la red virtual.

Tipo:PSSubnet[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Tag

Pares clave-valor en forma de tabla hash. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

String[]

PSSubnet[]

Hashtable

Salidas

PSVirtualNetwork