Mover os circuitos do ExpressRoute do modelo de implantação clássico para o do Resource Manager usando o PowerShell
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
.
- Verifique se você instalou os módulos clássico e Az Azure PowerShell localmente no seu computador. Para obter mais informações, confira Como instalar e configurar o Azure PowerShell.
- Leia os pré-requisitos, os requisitos de roteamento e os fluxos de trabalho antes de começar a configuração.
- Examine as informações fornecidas em Como mover um circuito de ExpressRoute do clássico para o Resource Manager. Certifique-se de entender completamente os limites e limitações.
- Verifique se o circuito está totalmente operacional no modelo de implantação clássico.
- Verifique se você tem um grupo de recursos que foi criado no modelo de implantação do Gerenciador de Recursos.
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.
Entre em sua conta do Azure.
Add-AzureAccount
Selecione a assinatura do Azure apropriada.
Select-AzureSubscription "<Enter Subscription Name here>"
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'
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.
Entre no ambiente do Azure Resource Manager.
Connect-AzAccount
Selecione a assinatura do Azure apropriada.
Get-AzSubscription -SubscriptionName "<Enter Subscription Name here>" | Select-AzSubscription
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:
Obtenha os detalhes do circuito.
$ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"
Defina "Permitir operações clássicas" como TRUE.
$ckt.AllowClassicOperations = $true
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
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
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.
Obtenha detalhes do circuito de ExpressRoute.
$ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"
Defina "Permitir operações clássicas" como FALSE.
$ckt.AllowClassicOperations = $false
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