Compartilhar via


Configurar uma rede virtual (clássico) usando um arquivo de configuração de rede

Importante

O Azure tem dois modelos de implantação diferentes para criar e trabalhar com recursos: Resource Manager e clássico. Este artigo aborda o uso do modelo de implantação clássica. A Microsoft recomenda que a maioria das implantações novas use o modelo de implantação do Gerenciador de Recursos.

Você pode criar e configurar uma rede virtual (clássica) com um arquivo de configuração de rede usando a CLI (interface de linha de comando) clássica do Azure ou o Azure PowerShell. Não é possível criar ou modificar uma rede virtual por meio do modelo de implantação do Azure Resource Manager usando um arquivo de configuração de rede. Não é possível utilizar o portal do Azure para criar ou modificar uma rede virtual (clássica) utilizando um arquivo de configuração de rede, no entanto, você pode usar o portal do Azure para criar uma rede virtual (clássica) sem utilizar um arquivo de configuração de rede.

Criar e configurar uma rede virtual (clássica) com um arquivo de configuração de rede requer exportar, alterar e importar o arquivo.

Exportar um arquivo de configuração de rede

É possível usar o PowerShell ou CLI clássica do Azure para exportar um arquivo de configuração de rede. O PowerShell exporta um arquivo XML, enquanto a CLI clássica do Azure exporta um arquivo JSON.

PowerShell

  1. Instalar o Azure PowerShell e entrar no Azure.

  2. Altere o diretório (e certifique-se de que ele existe) e o nome do arquivo no seguinte comando conforme desejado, em seguida, execute o comando para exportar o arquivo de configuração de rede:

    Get-AzureVNetConfig -ExportToFile c:\azure\networkconfig.xml
    

CLI clássica do Azure

  1. Instalar a CLI clássica do Azure. Conclua as etapas restantes em um prompt de comando da CLI clássica.

  2. Faça logon no Azure digitando o comando azure login.

  3. Certifique-se de que está no modo de asm inserindo o azure config mode asm comando.

  4. Altere o diretório (e certifique-se de que ele existe) e o nome do arquivo no seguinte comando conforme desejado, em seguida, execute o comando para exportar o arquivo de configuração de rede:

    azure network export c:\azure\networkconfig.json
    

Criar ou modificar um arquivo de configuração de rede

Um arquivo de configuração de rede é um arquivo XML (ao usar o PowerShell) ou um arquivo JSON (ao usar a CLI clássica). É possível editar o arquivo em qualquer texto ou editor XML/json. O artigo Configurações de esquema de arquivo de configuração de rede inclui detalhes de todas as configurações. Para obter explicações adicionais sobre as configurações, consulte Exibir redes virtuais e configurações. As alterações feitas no arquivo:

  • Deverão cumprir o esquema ou a importação do arquivo de configuração da rede falhará.
  • Substituirão todas as configurações de rede existentes para sua assinatura, portanto, tenha extremo cuidado ao realizar as modificações. Por exemplo, faça referência aos exemplos de arquivos de configuração de rede que se seguem. Digamos que o arquivo original continha duas instâncias VirtualNetworkSite e foram alteradas, conforme mostrado nos exemplos. Ao importar o arquivo, o Azure exclui a rede virtual da instância VirtualNetworkSite removida no arquivo. Esse cenário simplificado não considera recursos na rede virtual, como se existisse, a rede virtual não poderia ser excluída e, a importação falharia.

Importante

O Azure considera uma sub-rede com algo implantado como em uso. Quando uma sub-rede estiver em uso, ela não poderá ser modificada. Antes de modificar as informações de sub-rede em um arquivo de configuração de rede, mova todas as implantações existentes na sub-rede para uma sub-rede diferente que não está sendo modificada. Consulte Mover uma VM ou instância de função para uma sub-rede diferente para obter mais detalhes.

Exemplo de XML para uso com o PowerShell

O arquivo de configuração de rede de exemplo a seguir cria uma rede virtual nomeada myVirtualNetwork com um espaço de endereçamento de 10.0.0.0/16 na regão Leste dos EUA do Azure. A rede virtual contém uma sub-rede nomeada mySubnet com um prefixo de endereço 10.0.0.0/24.

<?xml version="1.0" encoding="utf-8"?>
<NetworkConfiguration xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns="https://schemas.microsoft.com/ServiceHosting/2011/07/NetworkConfiguration">
  <VirtualNetworkConfiguration>
    <Dns />
    <VirtualNetworkSites>
      <VirtualNetworkSite name="myVirtualNetwork" Location="East US">
        <AddressSpace>
          <AddressPrefix>10.0.0.0/16</AddressPrefix>
        </AddressSpace>
        <Subnets>
          <Subnet name="mySubnet">
            <AddressPrefix>10.0.0.0/24</AddressPrefix>
          </Subnet>
        </Subnets>
      </VirtualNetworkSite>
    </VirtualNetworkSites>
  </VirtualNetworkConfiguration>
</NetworkConfiguration>

Se o arquivo de configuração de rede que você exportou não contém conteúdo, você pode copiar o XML no exemplo anterior e colá-lo em um novo arquivo.

Exemplo de JSON para uso com a CLI clássica

O arquivo de configuração de rede de exemplo a seguir cria uma rede virtual nomeada myVirtualNetwork com um espaço de endereçamento de 10.0.0.0/16 na regão Leste dos EUA do Azure. A rede virtual contém uma sub-rede nomeada mySubnet com um prefixo de endereço 10.0.0.0/24.

{
   "VirtualNetworkConfiguration" : {
      "Dns" : "",
      "VirtualNetworkSites" : [
         {
            "AddressSpace" : [ "10.0.0.0/16" ],
            "Location" : "East US",
            "Name" : "myVirtualNetwork",
            "Subnets" : [
               {
                  "AddressPrefix" : "10.0.0.0/24",
                  "Name" : "mySubnet"
               }
            ]
         }
      ]
   }
}

Se o arquivo de configuração de rede que você exportou não contém conteúdo, você pode copiar o json no exemplo anterior e colá-lo em um novo arquivo.

Importar um arquivo de configuração de rede

Você pode usar o PowerShell ou a CLI clássica para importar um arquivo de configuração de rede. O PowerShell exporta um arquivo XML, enquanto a CLI clássica exporta um arquivo JSON. Se a importação falhar, confirme se o arquivo está em conformidade com o esquema de configuração de rede.

PowerShell

  1. Instalar o Azure PowerShell e entrar no Azure.

  2. Altere o diretório e o nome do arquivo no seguinte comando, conforme necessário, e execute o comando para importar o arquivo de configuração de rede:

    Set-AzureVNetConfig  -ConfigurationPath c:\azure\networkconfig.xml
    

CLI clássica do Azure

  1. Instalar a CLI clássica do Azure. Conclua as etapas restantes em um prompt de comando da CLI clássica.

  2. Faça logon no Azure digitando o comando azure login.

  3. Certifique-se de que está no modo de asm inserindo o azure config mode asm comando.

  4. Altere o diretório e o nome do arquivo no seguinte comando, conforme necessário, e execute o comando para importar o arquivo de configuração de rede:

    azure network import c:\azure\networkconfig.json