Mover os circuitos do ExpressRoute do modelo de implantação clássico para o do Resource Manager usando o PowerShell

  • Artigo

Para usar um circuito do ExpressRoute para os modelos de implantação clássico e do Resource Manager, você deve mover o circuito para o modelo de implantação do Resource Manager. As seções a seguir lhe ajudarão a mover seu circuito usando o PowerShell.

Antes de começar

As etapas e os exemplos deste artigo usam os módulos AZ do Azure PowerShell. Para instalar os módulos AZ localmente no computador, confira Instalar o Azure PowerShell. Para saber mais sobre o novo módulo AZ, confira Apresentando o novo módulo AZ do Azure PowerShell. Os cmdlets do PowerShell são atualizados com frequência. Se você não estiver executando a versão mais recente, os valores especificados nas instruções poderão falhar. Para localizar as versões instaladas do PowerShell no sistema, use o cmdlet Get-Module -ListAvailable Az.

Mover um circuito de ExpressRoute

Etapa 1: Coletar detalhes do circuito do modelo de implantação clássico

Entre no ambiente clássico do Azure e obtenha a chave de serviço.

  1. Entre em sua conta do Azure.

    Add-AzureAccount

  2. Selecione a assinatura do Azure apropriada.

    Select-AzureSubscription "<Enter Subscription Name here>"

  3. Importar os módulos do PowerShell para Azure e ExpressRoute.

    Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.1.1\Azure\Azure.psd1'
Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.1.1\ExpressRoute\ExpressRoute.psd1'

  4. Use o cmdlet abaixo para obter as chaves de serviço para todos os seus circuitos do ExpressRoute. Após a recuperação das chaves, copie a chave de serviço do circuito que você deseja mover para o modelo de implantação do Resource Manager.

    Get-AzureDedicatedCircuit

Etapa 2: Entrar e criar um grupo de recursos

Entre no ambiente do Resource Manager e crie um novo grupo de recursos.

  1. Entre no ambiente do Azure Resource Manager.

    Connect-AzAccount

  2. Selecione a assinatura do Azure apropriada.

    Get-AzSubscription -SubscriptionName "<Enter Subscription Name here>" | Select-AzSubscription

  3. Modifique o snippet a seguir para criar um novo grupo de recursos se você ainda não tiver um grupo de recursos.

    New-AzResourceGroup -Name "DemoRG" -Location "West US"

Etapa 3: Mover o circuito de ExpressRoute para o modelo de implantação do Gerenciador de Recursos

Agora você está pronto para mover o circuito de ExpressRoute do modelo de implantação clássico para o do Resource Manager. Antes de prosseguir, examine as informações fornecidas em Como mover circuitos de ExpressRoute do modelo de implantação clássico para o Resource Manager.

Para mover o circuito, modifique e execute o snippet a seguir:

Move-AzExpressRouteCircuit -Name "MyCircuit" -ResourceGroupName "DemoRG" -Location "West US" -ServiceKey "<Service-key>"

No modo clássico, um circuito ExpressRoute não tem o conceito de estar ligado a uma região. No Gerenciador de Recursos, todo recurso precisa ser mapeado para uma região do Azure. Tecnicamente, a região especificada no cmdlet Move-AzExpressRouteCircuit pode ser qualquer uma. Para propósitos organizacionais, você pode desejar escolher uma região que represente de perto seu local de emparelhamento.

Observação

  • Após você mover o circuito do ExpressRoute clássico para o modelo de implantação do Resource Manager, por padrão ele terá acesso aos modelos de implantação clássico e do Resource Manager.
  • O novo nome relacionado no cmdlet anterior será usado para referência ao recurso. O circuito essencialmente será renomeado.

Modificar o acesso de circuito

Para habilitar o acesso ao circuito de ExpressRoute para ambos os modelos de implantação

Você pode habilitar o acesso ao modelo de implantação clássico para circuitos do ExpressRoute criados no modelo de implantação do Resource Manager. Execute os cmdlets a seguir para habilitar o acesso a ambos os modelos de implantação:

  1. Obtenha os detalhes do circuito.

    $ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"

  2. Defina "Permitir operações clássicas" como TRUE.

    $ckt.AllowClassicOperations = $true

  3. Atualize o circuito. Depois que a operação for concluída com êxito, você poderá exibir o circuito no modelo de implantação clássico.

    Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt

  4. Execute o cmdlet a seguir para obter os detalhes do circuito de ExpressRoute. Você deve ser capaz de ver a chave de serviço relacionada.

    get-azurededicatedcircuit

  5. Agora você pode gerenciar links para o circuito do ExpressRoute usando os comandos do modelo de implantação clássico para redes virtuais clássicas e os comandos do Gerenciador de recursos para VNets do Gerenciador de recursos. Os artigos a seguir lhe ajudam a gerenciar links para o circuito de ExpressRoute:

Para desabilitar o circuito de ExpressRoute para o modelo de implantação clássico

Execute os cmdlets a seguir para desabilitar o acesso ao modelo de implantação clássico.

  1. Obtenha detalhes do circuito de ExpressRoute.

    $ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"

  2. Defina "Permitir operações clássicas" como FALSE.

    $ckt.AllowClassicOperations = $false

  3. Atualize o circuito. Depois que a operação for concluída com êxito, você não poderá exibir o circuito no modelo de implantação clássico.

    Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt

Próximas etapas