Partilhar via


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

Importante

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

Você pode criar e configurar uma rede virtual (clássica) com um arquivo de configuração de rede usando a interface de linha de comando clássica (CLI) 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. Você não pode usar o portal do Azure para criar ou modificar uma rede virtual (clássica) usando um arquivo de configuração de rede, no entanto, você pode usar o portal do Azure para criar uma rede virtual (clássica), sem usar 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

Você pode usar o PowerShell ou a 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. Instale o Azure PowerShell e entre no Azure.

  2. Altere o diretório (e verifique se ele existe) e o nome do arquivo no seguinte comando, conforme desejado, e 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. Instale a CLI clássica do Azure. Conclua as etapas restantes em um prompt de comando clássico da CLI.

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

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

  4. Altere o diretório (e verifique se ele existe) e o nome do arquivo no seguinte comando, conforme desejado, e 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). Você pode editar o arquivo em qualquer texto ou editor XML/json. O artigo Configurações do esquema do arquivo de configuração de rede inclui detalhes para 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:

  • Deve estar em conformidade com o esquema, ou a importação do arquivo de configuração de rede falhará.
  • Substitua quaisquer configurações de rede existentes da sua assinatura, portanto, tenha muito cuidado ao fazer modificações. Por exemplo, faça referência aos arquivos de configuração de rede de exemplo a seguir. Digamos que o arquivo original continha duas instâncias VirtualNetworkSite e você o alterou, conforme mostrado nos exemplos. Quando você importa o arquivo, o Azure exclui a rede virtual da instância do VirtualNetworkSite removida no arquivo. Esse cenário simplificado pressupõe que nenhum recurso estava na rede virtual, pois se houvesse, a rede virtual não poderia ser excluída e a importação falharia.

Importante

O Azure considera uma sub-rede que tem algo implantado nela como em uso. Quando uma sub-rede está em uso, ela não pode ser modificada. Antes de modificar as informações da sub-rede em um arquivo de configuração de rede, mova tudo o que você implantou na sub-rede para uma sub-rede diferente que não esteja sendo modificada. Consulte Mover uma VM ou instância de função para uma sub-rede diferente para obter detalhes.

Exemplo de XML para uso com o PowerShell

O arquivo de configuração de rede de exemplo a seguir cria uma rede virtual chamada myVirtualNetwork com um espaço de endereço de 10.0.0.0/16 na região Leste dos EUA Azure. A rede virtual contém uma sub-rede chamada mySubnet com um prefixo de endereço de 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 exportado não contiver conteúdo, você poderá 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 chamada myVirtualNetwork com um espaço de endereço de 10.0.0.0/16 na região Leste dos EUA Azure. A rede virtual contém uma sub-rede chamada mySubnet com um prefixo de endereço de 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 exportado não contiver conteúdo, você poderá 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 importa um arquivo XML, enquanto a CLI clássica importa 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. Instale o Azure PowerShell e entre no Azure.

  2. Altere o diretório e o nome do arquivo no seguinte comando conforme necessário e, em seguida, 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. Instale a CLI clássica do Azure. Conclua as etapas restantes em um prompt de comando clássico da CLI.

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

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

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

    azure network import c:\azure\networkconfig.json