Guia de início rápido: criar e modificar um circuito de Rota Expressa usando o Azure PowerShell
Este guia de início rápido mostra como criar um circuito de Rota Expressa em três tipos diferentes de resiliência: Resiliência Máxima, Alta Resiliência e Resiliência Padrão usando o Azure PowerShell. Você aprenderá como verificar o status, atualizar, excluir ou desprovisionar um circuito usando cmdlets do PowerShell.
Pré-requisitos
- Revise os pré-requisitos e fluxos de trabalho antes de iniciar a configuração.
- Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
- Azure PowerShell instalado localmente ou Azure Cloud Shell
Azure Cloud Shell
O Azure aloja o Azure Cloud Shell, um ambiente de shell interativo que pode utilizar através do seu browser. Pode utilizar o Bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. Você pode usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada em seu ambiente local.
Para iniciar o Azure Cloud Shell:
| Opção | Exemplo/Ligação |
|---|---|
| Selecione Experimentar no canto superior direito de um código ou bloco de comandos. Selecionar Experimentar não copia automaticamente o código ou comando para o Cloud Shell. |  |
| Aceda a https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir o Cloud Shell no browser. |  |
| Selecione o botão Cloud Shell na barra de menus, na parte direita do portal do Azure. |  |
Para usar o Azure Cloud Shell:
Inicie o Cloud Shell.
Selecione o botão Copiar em um bloco de código (ou bloco de comando) para copiar o código ou comando.
Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e Linux ou selecionando Cmd+Shift+V no macOS.
Selecione Enter para executar o código ou comando.
Criar e provisionar um circuito de Rota Expressa
Inicie sessão na sua conta do Azure e selecione a sua subscrição
Se estiver a utilizar o Azure Cloud Shell, inicie sessão na sua conta do Azure automaticamente depois de clicar em 'Experimentar'. Para entrar localmente, abra o console do PowerShell com privilégios elevados e execute o cmdlet para se conectar.
Connect-AzAccount
Se tiver mais do que uma subscrição, obtenha uma lista das suas subscrições do Azure.
Get-AzSubscription
Especifique a subscrição que pretende utilizar.
Select-AzSubscription -SubscriptionName "Name of subscription"
Obtenha a lista de fornecedores, localizações e larguras de banda suportados
Antes de criar um circuito de Rota Expressa, você precisa da lista de provedores de conectividade, locais e opções de largura de banda suportados.
O cmdlet do PowerShell Get-AzExpressRouteServiceProvider retorna essas informações, que você usa em etapas posteriores:
Get-AzExpressRouteServiceProvider
Verifique se o seu provedor de conectividade está listado lá. Anote as seguintes informações, que você precisa mais tarde ao criar um circuito:
- Nome
- EmparelhamentoLocais
- Larguras de bandaOferecidas
Agora você está pronto para criar um circuito de Rota Expressa.
Obtenha a lista de locais resilientes
Se você estiver criando um circuito de Rota Expressa com um tipo de resiliência de resiliência máxima, precisará conhecer a lista de locais resilientes. Aqui estão as etapas para recuperar essas informações:
Clone o script
# Clone the setup script from GitHub.
git clone https://github.com/Azure-Samples/azure-docs-powershell-samples/
# Change to the directory where the script is located.
CD azure-docs-powershell-samples/expressroute/
Executar script de locais resilientes
Execute o script Get-AzExpressRouteResilientLocations.ps1 para obter a lista de locais resilientes. O exemplo a seguir mostra como obter os locais resilientes para uma assinatura específica classificados por distância do Vale do Silício:
$SubscriptionId = Get-AzureSubscription -SubscriptionName "<SubscriptionName>"
highAvailabilitySetup/Get-AzExpressRouteResilientLocations.ps1 -SubscriptionId $SubscriptionId -RelativeLocation "silicon valley"
Se você não especificar o local, obterá uma lista de todos os locais resilientes.
Criar um circuito do ExpressRoute
Se você ainda não tiver um grupo de recursos, deverá criar um antes de criar seu circuito de Rota Expressa. Você pode fazer isso executando o cmdlet New-AzResourceGroup :
$resourceGroupName = (New-AzResourceGroup -Name "ExpressRouteResourceGroup" -Location "West US").ResourceGroupName
Se você já tiver um grupo de recursos, poderá usar Get-AzResourceGroup para obter o nome do grupo de recursos em uma variável:
$resourceGroupName = (Get-AzResourceGroup -Name "<ResourceGroupName>").ResourceGroupName
A resiliência máxima (recomendada) fornece o mais alto nível de resiliência para sua conexão de Rota Expressa. Ele fornece dois circuitos de Rota Expressa com redundância local em dois pontos de presença de Rota Expressa diferentes.
O exemplo a seguir mostra como criar dois circuitos ExpressRoute através do Equinix com redundância local no Vale do Silício e Washington DC. Se você estiver usando um provedor diferente e configurações diferentes, substitua essas informações quando fizer sua solicitação.
Nota
Este exemplo usa o script New-AzHighAvailabilityExpressRouteCircuits.ps1 . Você deve clonar o script do GitHub para criar os circuitos. Para obter mais informações, consulte Clonar o script.
$SubscriptionId = Get-AzureSubscription -SubscriptionName "<SubscriptionName>"
highAvailabilitySetup/New-AzHighAvailabilityExpressRouteCircuits.ps1 -SubscriptionId $SubscriptionId -ResourceGroupName $resourceGroupName -Location "westus" -Name1 $circuit1Name -Name2 $circuit2Name -SkuFamily1 "MeteredData" -SkuFamily2 "MeteredData" -SkuTier1 "Standard" -SkuTier2 "Standard" -ServiceProviderName1 "Equinix" -ServiceProviderName2 "Equinix" -PeeringLocation1 "Silicon Valley" -PeeringLocation2 "Washington DC" -BandwidthInMbps 1000
Nota
A Resiliência Máxima fornece a máxima proteção contra interrupções em todo o local e falhas de conectividade em um local da Rota Expressa. Esta opção é altamente recomendada para todas as cargas de trabalho críticas e de produção.
Certifique-se de especificar a camada de SKU e a família de SKU corretas:
- A camada de SKU determina se um circuito de Rota Expressa é Local, Standard ou Premium. Você pode especificar Local, *Standard ou Premium.
- A família SKU determina o tipo de faturamento. Você pode especificar MeteredData para um plano de dados monitorados e UnlimitedData para um plano de dados ilimitado. Você pode alterar o tipo de cobrança de MeteredData para UnlimitedData, mas não pode alterar o tipo de UnlimitedData para MeteredData. Um circuito local é sempre UnlimitedData.
Importante
Seu circuito de Rota Expressa é cobrado a partir do momento em que uma chave de serviço é emitida. Certifique-se de executar essa operação quando o provedor de conectividade estiver pronto para provisionar o circuito.
A resposta contém a chave de serviço. Você pode obter descrições detalhadas de todos os parâmetros executando o seguinte comando:
get-help New-AzExpressRouteCircuit -detailed
Listar todos os circuitos de Rota Expressa
Para obter uma lista de todos os circuitos ExpressRoute que você criou, execute o comando Get-AzExpressRouteCircuit :
Get-AzExpressRouteCircuit
A resposta é semelhante ao exemplo a seguir:
Name : ExpressRouteARMCircuit
ResourceGroupName : ExpressRouteResourceGroup
Location : westus
Id : /subscriptions/***************************/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit
Etag : W/"################################"
ProvisioningState : Succeeded
Sku : {
"Name": "Standard_MeteredData",
"Tier": "Standard",
"Family": "MeteredData"
}
CircuitProvisioningState : Enabled
ServiceProviderProvisioningState : NotProvisioned
ServiceProviderNotes :
ServiceProviderProperties : {
"ServiceProviderName": "Equinix",
"PeeringLocation": "Silicon Valley",
"BandwidthInMbps": 200
}
ServiceKey : **************************************
Peerings : []
Você pode recuperar essas informações a qualquer momento usando o Get-AzExpressRouteCircuit cmdlet. Fazer a chamada sem parâmetros lista todos os circuitos. Sua chave de serviço está listada no campo ServiceKey :
Get-AzExpressRouteCircuit
A resposta é semelhante ao exemplo a seguir:
Name : ExpressRouteARMCircuit
ResourceGroupName : ExpressRouteResourceGroup
Location : westus
Id : /subscriptions/***************************/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit
Etag : W/"################################"
ProvisioningState : Succeeded
Sku : {
"Name": "Standard_MeteredData",
"Tier": "Standard",
"Family": "MeteredData"
}
CircuitProvisioningState : Enabled
ServiceProviderProvisioningState : NotProvisioned
ServiceProviderNotes :
ServiceProviderProperties : {
"ServiceProviderName": "Equinix",
"PeeringLocation": "Silicon Valley",
"BandwidthInMbps": 200
}
ServiceKey : **************************************
Peerings : []
Envie a chave de serviço para seu provedor de conectividade para provisionamento
ServiceProviderProvisioningState fornece informações sobre o estado atual do provisionamento no lado do provedor de serviços. CircuitProvisioningState fornece o status no lado da Microsoft. Para obter mais informações sobre estados de provisionamento de circuito, consulte Fluxos de trabalho.
Quando você cria um novo circuito de Rota Expressa, o circuito está no seguinte estado:
ServiceProviderProvisioningState : NotProvisioned
CircuitProvisioningState : Enabled
O circuito muda para o seguinte estado quando o provedor de conectividade o está habilitando para você:
ServiceProviderProvisioningState : Provisioning
CircuitProvisioningState : Enabled
Para usar o circuito ExpressRoute, ele deve estar no seguinte estado:
ServiceProviderProvisioningState : Provisioned
CircuitProvisioningState : Enabled
Verifique periodicamente o estado e o estado da chave do circuito
Verificar o status e o estado da chave de serviço permite que você saiba quando seu provedor provisionou seu circuito. Depois que o circuito é configurado, ServiceProviderProvisioningState aparece como Provisionado, conforme mostrado no exemplo a seguir:
Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"
A resposta é semelhante ao exemplo a seguir:
Name : ExpressRouteARMCircuit
ResourceGroupName : ExpressRouteResourceGroup
Location : westus
Id : /subscriptions/***************************/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit
Etag : W/"################################"
ProvisioningState : Succeeded
Sku : {
"Name": "Standard_MeteredData",
"Tier": "Standard",
"Family": "MeteredData"
}
CircuitProvisioningState : Enabled
ServiceProviderProvisioningState : Provisioned
ServiceProviderNotes :
ServiceProviderProperties : {
"ServiceProviderName": "Equinix",
"PeeringLocation": "Silicon Valley",
"BandwidthInMbps": 200
}
ServiceKey : **************************************
Peerings : []
Crie sua configuração de roteamento
Para obter instruções passo a passo, consulte o artigo Configuração de roteamento de circuito da Rota Expressa para criar e modificar emparelhamentos de circuitos.
Importante
Estas instruções aplicam-se apenas a circuitos criados com fornecedores de serviços que oferecem serviços de conectividade de camada 2. Se você estiver usando um provedor de serviços que oferece serviços gerenciados de camada 3 (normalmente uma VPN IP, como MPLS), seu provedor de conectividade configura e gerencia o roteamento para você.
Ligar uma rede virtual a um circuito ExpressRoute
Em seguida, vincule uma rede virtual ao circuito da Rota Expressa. Use o artigo Vinculando redes virtuais a circuitos de Rota Expressa ao trabalhar com o modelo de implantação do Gerenciador de Recursos.
Obtendo o status de um circuito de Rota Expressa
Você pode recuperar essas informações a qualquer momento usando o cmdlet Get-AzExpressRouteCircuit . Fazer a chamada sem parâmetros lista todos os circuitos.
Get-AzExpressRouteCircuit
A resposta é semelhante ao seguinte exemplo:
Name : ExpressRouteARMCircuit
ResourceGroupName : ExpressRouteResourceGroup
Location : westus
Id : /subscriptions/***************************/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit
Etag : W/"################################"
ProvisioningState : Succeeded
Sku : {
"Name": "Standard_MeteredData",
"Tier": "Standard",
"Family": "MeteredData"
}
CircuitProvisioningState : Enabled
ServiceProviderProvisioningState : Provisioned
ServiceProviderNotes :
ServiceProviderProperties : {
"ServiceProviderName": "Equinix",
"PeeringLocation": "Silicon Valley",
"BandwidthInMbps": 200
}
ServiceKey : **************************************
Peerings : []
Você pode obter informações sobre um circuito de Rota Expressa específico passando o nome do grupo de recursos e o nome do circuito como um parâmetro para a chamada:
Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"
A resposta é semelhante ao exemplo a seguir:
Name : ExpressRouteARMCircuit
ResourceGroupName : ExpressRouteResourceGroup
Location : westus
Id : /subscriptions/***************************/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit
Etag : W/"################################"
ProvisioningState : Succeeded
Sku : {
"Name": "Standard_MeteredData",
"Tier": "Standard",
"Family": "MeteredData"
}
CircuitProvisioningState : Enabled
ServiceProviderProvisioningState : Provisioned
ServiceProviderNotes :
ServiceProviderProperties : {
"ServiceProviderName": "Equinix",
"PeeringLocation": "Silicon Valley",
"BandwidthInMbps": 200
}
ServiceKey : **************************************
Peerings : []
Você pode obter descrições detalhadas de todos os parâmetros executando o seguinte comando:
get-help Get-AzExpressRouteCircuit -detailed
Modificando um circuito de Rota Expressa
Pode modificar determinadas propriedades de um circuito do ExpressRoute sem afetar a conectividade.
Você pode executar as seguintes tarefas sem tempo de inatividade:
- Habilite ou desabilite um complemento premium da Rota Expressa para seu circuito da Rota Expressa.
- Aumente a largura de banda do seu circuito de Rota Expressa, desde que haja capacidade disponível na porta. Não há suporte para downgrade da largura de banda de um circuito.
- Altere o plano de medição de Dados Medidos para Dados Ilimitados. Não há suporte para alterar o plano de medição de Dados ilimitados para Dados monitorados.
- Você pode habilitar e desabilitar Permitir operações clássicas.
Para obter mais informações sobre limites e limitações, consulte as Perguntas frequentes sobre a Rota Expressa.
Para habilitar o complemento premium da Rota Expressa
Você pode habilitar o complemento premium ExpressRoute para seu circuito existente usando o seguinte trecho do PowerShell:
$ckt = Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"
$ckt.Sku.Tier = "Premium"
$ckt.sku.Name = "Premium_MeteredData"
Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
O circuito agora tem os recursos de complemento premium ExpressRoute ativados. Começamos a cobrar o recurso de complemento premium assim que o comando for executado com sucesso.
Para desativar o complemento premium ExpressRoute
Importante
Se você estiver usando recursos maiores do que o permitido para o circuito padrão, essa operação poderá falhar.
Tenha em atenção as seguintes informações:
- Antes de mudar de premium para standard, tem de garantir que o número de redes virtuais que estão ligadas ao circuito é inferior a 10. Se não o fizer, o seu pedido de atualização falha e faturamos-lhe as tarifas premium.
- Todas as redes virtuais noutras regiões geopolíticas têm de ser primeiro desligadas. Se você não remover o link, sua solicitação de atualização falhará e continuaremos a cobrar tarifas premium.
- A sua tabela de rotas tem de ser inferior a 4000 rotas para o peering privado. Se o tamanho da tabela de rotas for maior que 4.000 rotas, a sessão BGP será interrompida. A sessão BGP não é restabelecida até que o número de prefixos anunciados seja inferior a 4.000.
Você pode desabilitar o complemento premium ExpressRoute para o circuito existente usando o seguinte cmdlet do PowerShell:
$ckt = Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"
$ckt.Sku.Tier = "Standard"
$ckt.sku.Name = "Standard_MeteredData"
Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
Para atualizar a largura de banda do circuito ExpressRoute
Para obter as opções de largura de banda suportadas pelo seu provedor, consulte as Perguntas frequentes sobre a Rota Expressa. Você pode escolher qualquer tamanho maior do que o tamanho do seu circuito existente.
Importante
Poderá ter de recriar o circuito do ExpressRoute se existir uma capacidade inadequada na porta existente. Não pode atualizar o circuito se não existir capacidade adicional disponível nessa localização.
Não é possível reduzir a largura de banda de um circuito de Rota Expressa sem interrupção. A redução da largura de banda requer que desaprovisione o circuito do ExpressRoute e, em seguida, reaprovisione um novo circuito do ExpressRoute.
Depois de decidir o tamanho necessário, use o seguinte comando para redimensionar o circuito:
$ckt = Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"
$ckt.ServiceProviderProperties.BandwidthInMbps = 1000
Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
Seu circuito é atualizado no lado da Microsoft. Em seguida, você deve entrar em contato com seu provedor de conectividade para atualizar as configurações do lado dele para corresponder a essa alteração. Depois de fazer essa notificação, começaremos a cobrar pela opção de largura de banda atualizada.
Para mover o SKU de medido para ilimitado
Você pode alterar a SKU de um circuito de Rota Expressa usando o seguinte trecho do PowerShell:
$ckt = Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"
$ckt.Sku.Family = "UnlimitedData"
$ckt.sku.Name = "Premium_UnlimitedData"
Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
Para controlar o acesso aos ambientes clássico e do Resource Manager
Analise as instruções em Mover circuitos de Rota Expressa do modelo de implantação clássico para o Resource Manager.
Desprovisionando um circuito de Rota Expressa
Tenha em atenção as seguintes informações:
- Todas as redes virtuais têm de estar desassociadas do circuito do ExpressRoute. Se esta operação falhar, verifique se existem redes virtuais ligadas ao circuito.
- Se o estado de provisionamento do provedor de serviços de circuito de Rota Expressa for Provisionamento ou Provisionado, você deverá trabalhar com seu provedor de serviços para desprovisionar o circuito do lado dele. Continuamos a reservar recursos e a cobrar até que o fornecedor de serviços conclua o desaprovisionamento do circuito e nos notifique.
- Se o provedor de serviços desprovisionou o circuito, o que significa que o estado de provisionamento do provedor de serviços será definido como Não provisionado, você poderá excluir o circuito. A faturação do circuito para.
Clean up resources (Limpar recursos)
Você pode excluir seu circuito de Rota Expressa executando o seguinte comando:
Remove-AzExpressRouteCircuit -ResourceGroupName "ExpressRouteResourceGroup" -Name "ExpressRouteARMCircuit"
Próximos passos
Depois de criar seu circuito e provisioná-lo com seu provedor, continue para a próxima etapa para configurar o emparelhamento: