New-AzVirtualNetwork

  • Referencia
Módulo:
Az.Network

Crea una red virtual.

Sintaxis

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>]

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. Al especificar los servidores DNS en la red virtual se consigue que las NIC/máquinas virtuales que están implementadas en esta red virtual hereden estos servidores DNS según los 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.

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 solicita su 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 al comando a ejecutarse sin solicitar la 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

-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 se ejecutara el cmdlet. 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