Partilhar via

New-AzVirtualNetwork

  • Referência
Módulo:
Az.Network

Cria uma rede virtual.

Sintaxe

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

O cmdlet New-AzVirtualNetwork cria uma rede virtual do Azure.

Exemplos

Exemplo 1: Criar uma rede virtual com duas sub-redes

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

Este exemplo cria uma rede virtual com duas sub-redes. Primeiro, um novo grupo de recursos é criado na região central. Em seguida, o exemplo cria representações na memória de duas sub-redes. O cmdlet New-AzVirtualNetworkSubnetConfig não criará nenhuma sub-rede no lado do servidor. Há uma sub-rede chamada frontendSubnet e uma sub-rede chamada backendSubnet. Em seguida, o cmdlet New-AzVirtualNetwork cria uma rede virtual usando o CIDR 10.0.0.0/16 como prefixo de endereço e duas sub-redes.

Exemplo 2: Criar uma rede virtual com configurações 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

Este exemplo cria uma rede virtual com duas sub-redes e dois servidores DNS. O efeito de especificar os servidores DNS na rede virtual é que as NICs/VMs implantadas nessa rede virtual herdam esses servidores DNS como padrão. Esses padrões podem ser substituídos por NIC por meio de uma configuração de nível de NIC. Se nenhum servidor DNS for especificado em uma VNET e nenhum servidor DNS nas NICs, os servidores DNS padrão do Azure serão usados para resolução de DNS.

Exemplo 3: Criar uma rede virtual com uma sub-rede fazendo referência a um grupo de segurança de rede

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

Este exemplo cria uma rede virtual com sub-redes que fazem referência a um grupo de segurança de rede. Primeiro, o exemplo cria um grupo de recursos como um contêiner para os recursos que serão criados. Em seguida, é criado um grupo de segurança de rede que permite acesso RDP de entrada, mas que impõe as regras padrão do grupo de segurança de rede. Em seguida, o cmdlet New-AzVirtualNetworkSubnetConfig cria representações na memória de duas sub-redes que fazem referência ao grupo de segurança de rede criado. Em seguida, o comando New-AzVirtualNetwork cria a rede virtual.

Exemplo 4: Criar uma rede virtual com um Pool de IPAM para alocação automática de prefixos de endereço

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

Este exemplo cria uma rede virtual com um pool IPAM (IP Address Management) para alocar automaticamente prefixos de endereço. Primeiro, um pool de IPAM chamado testIpamPool é criado no grupo de recursos testRG e no gerenciador de rede testNM na região centralus com o prefixo de endereço 10.0.0.0/16. O cmdlet Get-AzNetworkManagerIpamPool recupera o pool do IPAM que acabou de ser criado. Em seguida, um objeto personalizado que representa a alocação de prefixo do pool do IPAM é criado. Este objeto inclui a Id do pool do IPAM e o NumberOfIpAddresses a alocar. O cmdlet New-AzVirtualNetworkSubnetConfig cria uma sub-rede chamada testSubnet configurada para usar o objeto de alocação de prefixo do pool do IPAM. Finalmente, o cmdlet New-AzVirtualNetwork cria uma rede virtual chamada testVnet no grupo de recursos testRG e no local centralus. A rede virtual inclui a sub-rede criada na etapa anterior e usa a alocação de prefixo do pool do IPAM para alocação de prefixo de endereço.

Parâmetros

-AddressPrefix

Especifica um intervalo de endereços IP para uma rede virtual.

Tipo:String[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-BgpCommunity

A Comunidade BGP anunciava através da Rota Expressa.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DdosProtectionPlanId

Referência ao recurso do plano de proteção contra DDoS associado à rede virtual.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DnsServer

Especifica o servidor DNS de uma sub-rede.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-EdgeZone

{{ Preencher Descrição da EdgeZone }}

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-EnableDdosProtection

Um parâmetro de switch que representa se a proteção contra DDoS está habilitada ou não.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EnableEncryption

Indica se a criptografia está habilitada na rede virtual. O valor deve ser true para habilitar a criptografia na rede virtual, false para desabilitar a criptografia.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-EncryptionEnforcementPolicy

Defina a Encryption EnforcementPolicy. O valor deve ser allowUnencrypted para permitir VMs sem capacidade de criptografia dentro de uma rede virtual criptografada ou dropUnencrypted para desabilitar qualquer VM sem capacidade de criptografia de ser adicionada a uma rede virtual criptografada.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-FlowTimeout

O FlowTimeout permite o rastreamento de conexões para fluxos intra-VM. O valor deve estar entre 4 e 30 minutos (inclusive) para habilitar o rastreamento, ou null para desabilitar o rastreamento.

Tipo:Nullable<T>[Int32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IpAllocation

Especifica IpAllocations para uma rede virtual.

Tipo:PSIpAllocation[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-IpamPoolPrefixAllocation

Especifica uma lista de objetos PSIpamPoolPrefixAllocation a partir dos quais alocar automaticamente para prefixos de endereço de rede virtual.

Tipo:Microsoft.Azure.Commands.Network.Models.PSIpamPoolPrefixAllocation[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Location

Especifica a região da rede virtual.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

Especifica o nome da rede virtual criada por esse cmdlet.

Tipo:String
Aliases:ResourceName
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PrivateEndpointVNetPoliciesValue

O PrivateEndpointVNetPolicies da rede virtual

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceGroupName

Especifica o nome de um grupo de recursos para conter a rede virtual.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Subnet

Especifica uma lista de sub-redes a serem associadas à rede virtual.

Tipo:PSSubnet[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Tag

Pares chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; chave1=$null; key2="valor2"}

Tipo:Hashtable
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

String[]

PSSubnet[]

Hashtable

Saídas

PSVirtualNetwork