New-AzVirtualNetwork

Módulo:

Az.Network Module

Cria uma rede virtual.

Sintaxe

Default (Predefiniçã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. 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.

Propriedades dos parâmetros

Tipo:	String[]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-AsJob

Executar cmdlet em segundo plano

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-BgpCommunity

A Comunidade BGP anunciava através da Rota Expressa.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	False
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Cf.

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-DdosProtectionPlanId

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

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:	IAzureContextContainer
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-DnsServer

Especifica o servidor DNS de uma sub-rede.

Propriedades dos parâmetros

Tipo:	String[]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-EdgeZone

{{ Preencher Descrição da EdgeZone }}

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-EnableDdosProtection

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

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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 dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	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.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	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.

Propriedades dos parâmetros

Tipo:	Nullable<T>[Int32]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Force

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

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-IpAllocation

Especifica IpAllocations para uma rede virtual.

Propriedades dos parâmetros

Tipo:	PSIpAllocation[]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-IpamPoolPrefixAllocation

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

Propriedades dos parâmetros

Tipo:	PSIpamPoolPrefixAllocation[]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Location

Especifica a região da rede virtual.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Name

Especifica o nome da rede virtual criada por esse cmdlet.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Nome do Recurso

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-PrivateEndpointVNetPoliciesValue

O PrivateEndpointVNetPolicies da rede virtual

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-ResourceGroupName

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

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Subnet

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

Propriedades dos parâmetros

Tipo:	PSSubnet[]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Tag

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

Propriedades dos parâmetros

Tipo:	Hashtable
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-WhatIf

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

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	False
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Wi

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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

Ligações Relacionadas

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