Configure uma rede virtual (clássica) usando um ficheiro de configuração de rede

Importante

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

Pode criar e configurar uma rede virtual (clássica) com um ficheiro de configuração de rede utilizando a interface clássica de linha de comando (CLI) ou Azure PowerShell. Não é possível criar ou modificar uma rede virtual através do modelo de implementação do Gestor de Recursos Azure utilizando um ficheiro de configuração de rede. Não é possível utilizar o portal Azure para criar ou modificar uma rede virtual (clássica) utilizando um ficheiro de configuração de rede, no entanto pode utilizar o portal Azure para criar uma rede virtual (clássica), sem utilizar um ficheiro de configuração de rede.

Criar e configurar uma rede virtual (clássica) com um ficheiro de configuração de rede requer exportação, alteração e importação do ficheiro.

Exportar um ficheiro de configuração de rede

Pode utilizar o PowerShell ou o CLI clássico do Azure para exportar um ficheiro de configuração de rede. A PowerShell exporta um ficheiro XML, enquanto o CLI clássico do Azure exporta um ficheiro json.

PowerShell

  1. Instale Azure PowerShell e inscreva-se no Azure.

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

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

CLI clássica do Azure

  1. Instale o CLI clássico do Azure. Complete os passos restantes de um pedido de comando clássico do CLI.

  2. Faça login em Azure entrando no azure login comando.

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

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

    azure network export c:\azure\networkconfig.json
    

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

Um ficheiro de configuração de rede é um ficheiro XML (quando se utiliza o PowerShell) ou um ficheiro json (quando se utiliza o CLI clássico). Pode editar o ficheiro em qualquer texto ou editor XML/json. O artigo de definição de esquemas de configuração da Rede inclui detalhes para todas as definições. Para obter uma explicação adicional das definições, consulte as redes virtuais e as definições. As alterações que faz no ficheiro:

  • Deve cumprir o esquema, ou importar o ficheiro de configuração da rede falhará.
  • Substitua as definições de rede existentes para a sua subscrição, por isso tenha muito cuidado ao esporar modificações. Por exemplo, consulte os ficheiros de configuração de rede de exemplo que se seguem. Digamos que o ficheiro original continha duas instâncias VirtualNetworkSite, e que o alterou, como mostram os exemplos. Quando importa o ficheiro, o Azure elimina a rede virtual para a instância VirtualNetworkSite que removeu no ficheiro. Este cenário simplificado pressupõe que não existiam recursos na rede virtual, como se existisse, a rede virtual não podia ser eliminada e a importação falharia.

Importante

A Azure considera uma sub-rede que tem algo implantado como em uso. Quando uma sub-rede está a ser utilizada, não pode ser modificada. Antes de modificar as informações da sub-rede num ficheiro de configuração de rede, mova tudo o que tenha implantado na sub-rede para uma sub-rede diferente que não esteja a ser modificada. Consulte um VM ou Role Instance para uma sub-rede diferente para obter detalhes.

Exemplo XML para utilização com PowerShell

O seguinte exemplo de ficheiro de configuração de rede cria uma rede virtual chamada myVirtualNetwork com um espaço de endereço de 10.0.0.0/16 na região de Azure Leste dos EUA. 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 ficheiro de configuração de rede que exportaste não contiver conteúdo, pode copiar o XML no exemplo anterior e colá-lo num novo ficheiro.

Exemplo JSON para uso com o CLI clássico

O seguinte exemplo de ficheiro de configuração de rede cria uma rede virtual chamada myVirtualNetwork com um espaço de endereço de 10.0.0.0/16 na região de Azure Leste dos EUA. 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 ficheiro de configuração de rede que exportaste não contiver conteúdo, pode copiar o json no exemplo anterior e colá-lo num novo ficheiro.

Importar um ficheiro de configuração de rede

Pode utilizar o PowerShell ou o CLI clássico para importar um ficheiro de configuração de rede. PowerShell importa um ficheiro XML, enquanto o clássico CLI importa um ficheiro json. Se a importação falhar, confirme que o ficheiro está em conformidade com o esquema de configuraçãoda rede .

PowerShell

  1. Instale Azure PowerShell e inscreva-se no Azure.

  2. Altere o diretório e o nome de ficheiro no seguinte comando, se necessário, e, em seguida, executar o comando para importar o ficheiro de configuração da rede:

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

CLI clássica do Azure

  1. Instale o CLI clássico do Azure. Complete os passos restantes de um pedido de comando clássico do CLI.

  2. Faça login em Azure entrando no azure login comando.

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

  4. Altere o diretório e o nome de ficheiro no seguinte comando, se necessário, e, em seguida, executar o comando para importar o ficheiro de configuração da rede:

    azure network import c:\azure\networkconfig.json