Mover circuitos do ExpressRoute do modelo de implementação clássico para Resource Manager com o PowerShell

Para utilizar um circuito do ExpressRoute para os modelos de implementação clássicos e Resource Manager, tem de mover o circuito para o modelo de implementação Resource Manager. As secções seguintes ajudam-no a mover o circuito com o PowerShell.

Antes de começar

Os passos e exemplos neste artigo utilizam Azure PowerShell módulos do Az. Para instalar os módulos do Az localmente no seu computador, consulte Instalar Azure PowerShell. Para saber mais sobre o novo módulo do Az, veja Introdução ao novo módulo Azure PowerShell Az. Os cmdlets do PowerShell são atualizados com frequência. Se não estiver a executar a versão mais recente, os valores especificados nas instruções poderão falhar. Para localizar as versões instaladas do PowerShell no seu sistema, utilize o Get-Module -ListAvailable Az cmdlet.

Mover um circuito do ExpressRoute

Passo 1: recolher detalhes do circuito do modelo de implementação clássica

Inicie sessão no ambiente clássico do Azure e reúna a chave de serviço.

  1. Inicie sessão na sua conta do Azure.

    Add-AzureAccount
    
  2. Selecione a subscrição do Azure adequada.

    Select-AzureSubscription "<Enter Subscription Name here>"
    
  3. Importe os módulos do PowerShell para o Azure e o 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. Utilize o cmdlet abaixo para obter as chaves de serviço de todos os circuitos do ExpressRoute. Depois de obter as chaves, copie a chave de serviço do circuito que pretende mover para o modelo de implementação Resource Manager.

    Get-AzureDedicatedCircuit
    

Passo 2: Iniciar sessão e criar um grupo de recursos

Inicie sessão no ambiente Resource Manager e crie um novo grupo de recursos.

  1. Inicie sessão no seu ambiente de Resource Manager do Azure.

    Connect-AzAccount
    
  2. Selecione a subscrição do Azure adequada.

    Get-AzSubscription -SubscriptionName "<Enter Subscription Name here>" | Select-AzSubscription
    
  3. Modifique o fragmento abaixo para criar um novo grupo de recursos se ainda não tiver um grupo de recursos.

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

Passo 3: mover o circuito do ExpressRoute para o modelo de implementação Resource Manager

Está agora pronto para mover o circuito do ExpressRoute do modelo de implementação clássica para o modelo de implementação Resource Manager. Antes de continuar, reveja as informações fornecidas em Mover um circuito do ExpressRoute do clássico para o modelo de implementação Resource Manager.

Para mover o circuito, modifique e execute o seguinte fragmento:

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

No modo clássico, um circuito do ExpressRoute não tem o conceito de estar ligado a uma região. No entanto, no Resource Manager, todos os recursos têm de ser mapeados para uma região do Azure. A região especificada no cmdlet Move-AzExpressRouteCircuit pode ser tecnicamente qualquer região. Para fins organizacionais, pode querer escolher uma região que represente de perto a sua localização de peering.

Nota

  • Depois de mover o circuito clássico do ExpressRoute para o modelo de implementação Resource Manager, terá acesso aos modelos de implementação clássicos e Resource Manager por predefinição.
  • O novo nome listado no cmdlet anterior será utilizado para abordar o recurso. O circuito será essencialmente mudado.

Modificar o acesso ao circuito

Para ativar o acesso ao circuito do ExpressRoute para ambos os modelos de implementação

Pode ativar o acesso ao modelo de implementação clássica para circuitos do ExpressRoute que foram criados no modelo de implementação Resource Manager. Execute os seguintes cmdlets para permitir o acesso a ambos os modelos de implementação:

  1. Obtenha os detalhes do circuito.

    $ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"
    
  2. Defina "Permitir Operações Clássicas" como VERDADEIRO.

    $ckt.AllowClassicOperations = $true
    
  3. Atualize o circuito. Após a conclusão desta operação com êxito, poderá ver o circuito no modelo de implementação clássica.

    Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
    
  4. Execute o seguinte cmdlet para obter os detalhes do circuito do ExpressRoute. Tem de conseguir ver a chave de serviço listada.

    get-azurededicatedcircuit
    
  5. Agora, pode gerir ligações para o circuito do ExpressRoute com os comandos do modelo de implementação clássica para VNets clássicas e os comandos de Resource Manager para Resource Manager VNets. Os seguintes artigos ajudam-no a gerir ligações para o circuito do ExpressRoute:

Para desativar o acesso do circuito do ExpressRoute ao modelo de implementação clássica

Execute os seguintes cmdlets para desativar o acesso ao modelo de implementação clássica.

  1. Obtenha detalhes sobre o circuito do ExpressRoute.

    $ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"
    
  2. Defina "Permitir Operações Clássicas" como FALSO.

    $ckt.AllowClassicOperations = $false
    
  3. Atualize o circuito. Após a conclusão desta operação com êxito, não poderá ver o circuito no modelo de implementação clássica.

    Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
    

Passos seguintes