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.
- Verifique se instalou os módulos clássicos e do Az Azure PowerShell localmente no seu computador. Para obter mais informações, veja How to install and configure Azure PowerShell (Como instalar e configurar o Azure PowerShell).
- Certifique-se de que reviu os pré-requisitos, os requisitos de encaminhamento e os fluxos de trabalho antes de iniciar a configuração.
- Reveja as informações fornecidas em Mover um circuito do ExpressRoute de clássico para Resource Manager. Certifique-se de que compreende totalmente os limites e limitações.
- Verifique se o circuito está totalmente operacional no modelo de implementação clássica.
- Certifique-se de que tem um grupo de recursos que foi criado no modelo de implementação Resource Manager.
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.
Inicie sessão na sua conta do Azure.
Add-AzureAccount
Selecione a subscrição do Azure adequada.
Select-AzureSubscription "<Enter Subscription Name here>"
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'
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.
Inicie sessão no seu ambiente de Resource Manager do Azure.
Connect-AzAccount
Selecione a subscrição do Azure adequada.
Get-AzSubscription -SubscriptionName "<Enter Subscription Name here>" | Select-AzSubscription
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:
Obtenha os detalhes do circuito.
$ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"
Defina "Permitir Operações Clássicas" como VERDADEIRO.
$ckt.AllowClassicOperations = $true
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
Execute o seguinte cmdlet para obter os detalhes do circuito do ExpressRoute. Tem de conseguir ver a chave de serviço listada.
get-azurededicatedcircuit
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.
Obtenha detalhes sobre o circuito do ExpressRoute.
$ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"
Defina "Permitir Operações Clássicas" como FALSO.
$ckt.AllowClassicOperations = $false
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