Compartilhar via


New-AzVirtualNetwork

Cria uma rede virtual.

Sintaxe

Default (Padrão)

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. O cmdlet New-AzVirtualNetwork cria uma rede virtual usando o CIDR 10.0.0.0/16 como o 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 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 DNS.

Exemplo 3: Criar uma rede virtual com uma sub-rede que faz 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, um grupo de segurança de rede é criado que permite acesso rdp de entrada, mas, caso contrário, impõe as regras de grupo de segurança de rede padrão. 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 que foi criado. Em seguida, o comando New-AzVirtualNetwork cria a rede virtual.

Exemplo 4: Criar uma rede virtual com um pool de IPAM para alocar automaticamente para 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 de IPAM (Gerenciamento de Endereço IP) 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 centralizada com o prefixo de endereço 10.0.0.0/16. O cmdlet Get-AzNetworkManagerIpamPool recupera o pool de IPAM que acabou de ser criado. Em seguida, um objeto personalizado que representa a alocação de prefixo do pool de IPAM é criado. Esse objeto inclui a ID do pool de IPAM e o NumberOfIpAddresses a ser alocado. O cmdlet New-AzVirtualNetworkSubnetConfig cria uma sub-rede chamada testSubnet configurada para usar o objeto de alocação de prefixo do pool de IPAM. Por fim, o cmdlet New-AzVirtualNetwork cria uma rede virtual chamada testVnet no grupo de recursos testRG e no local centralizado. A rede virtual inclui a sub-rede criada na etapa anterior e usa a alocação de prefixo do pool de IPAM para alocação de prefixo de endereço.

Parâmetros

-AddressPrefix

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-AsJob

Executar cmdlet em segundo plano

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-BgpCommunity

A comunidade BGP anunciava pelo ExpressRoute.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DdosProtectionPlanId

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DnsServer

Especifica o servidor DNS para uma sub-rede.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-EdgeZone

{{ Preencher Descrição da Zona de Borda }}

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-EnableDdosProtection

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-EncryptionEnforcementPolicy

Defina a Encryption EnforcementPolicy. O valor deve ser allowUnencrypted para permitir que 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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-FlowTimeout

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

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Force

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IpAllocation

Especifica IpAllocations para uma rede virtual.

Propriedades do parâmetro

Tipo:

PSIpAllocation[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IpamPoolPrefixAllocation

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

Propriedades do parâmetro

Tipo:

PSIpamPoolPrefixAllocation[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Location

Especifica a região da rede virtual.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

Especifica o nome da rede virtual que esse cmdlet cria.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:NomeDoRecurso

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-PrivateEndpointVNetPoliciesValue

O PrivateEndpointVNetPolicies da rede virtual

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ResourceGroupName

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Subnet

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

Propriedades do parâmetro

Tipo:

PSSubnet[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Tag

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

Propriedades do parâmetro

Tipo:Hashtable
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

String

PSSubnet

Hashtable

Saídas

PSVirtualNetwork