Partilhar via

Associar ASN par à assinatura do Azure usando o PowerShell

  • Artigo

Antes de enviar uma solicitação de emparelhamento, você deve primeiro associar seu ASN à assinatura do Azure usando as etapas neste artigo.

Se preferir, você pode concluir este guia usando o portal do Azure.

Trabalhando com o Azure PowerShell

Para executar os cmdlets, você pode usar o Azure Cloud Shell, um shell interativo gratuito. Tem as ferramentas comuns do Azure pré-instaladas e configuradas para utilização com a sua conta. Selecione Copiar para copiar o código e cole-o no Cloud Shell. Em seguida, selecione Enter para executá-lo. Existem algumas maneiras de iniciar o Cloud Shell:

Método de lançamento Captura de ecrã
Abrir o Cloud Shell no seu browser. https://shell.azure.com/powershell
Selecione o botão Cloud Shell na barra de ferramentas no canto superior direito do portal do Azure. Cloud Shell in the portal

Se você não quiser usar o Azure Cloud Shell, poderá instalar o PowerShell localmente. Se você optar por instalar e usar o PowerShell localmente, certifique-se de instalar a versão mais recente dos cmdlets do PowerShell do Azure Resource Manager. Os cmdlets do PowerShell são atualizados com frequência. Normalmente, você precisa atualizar seus cmdlets do PowerShell para obter a funcionalidade de recurso mais recente. Se não o fizer, poderá encontrar problemas.

Para localizar a versão do PowerShell que você está executando localmente, use o cmdlet 'Get-Module -ListAvailable Az' . Para atualizar, consulte Instalar o módulo do Azure PowerShell. Para obter mais informações, consulte como instalar e configurar o Azure PowerShell.

Se você usa o PowerShell no macOS, siga as etapas em Instalando o PowerShell no macOS.

Criar PeerASN para associar seu ASN à Assinatura do Azure

Inicie sessão na sua conta do Azure e selecione a sua subscrição

Antes de iniciar a configuração, instale e importe os módulos necessários. Você precisa de privilégios de administrador para instalar módulos no PowerShell.

  1. Instale e importe o módulo Az.

    Install-Module Az -AllowClobber
Import-Module Az

  2. Instale e importe o módulo Az.Peering.

    Install-Module -Name Az.Peering -AllowClobber
Import-Module Az.Peering

  3. Verifique se os módulos foram importados corretamente usando este comando:

    Get-Module

  4. Entre na sua conta do Azure usando este comando:

    Connect-AzAccount

  5. Verifique as subscrições da conta e selecione a subscrição na qual pretende criar um emparelhamento.

    Get-AzSubscription
Select-AzSubscription -SubscriptionId "subscription-id"

  6. Se você ainda não tiver um grupo de recursos, deverá criar um antes de criar um emparelhamento. Você pode fazer isso executando o seguinte comando:

    New-AzResourceGroup -Name "PeeringResourceGroup" -Location "Central US"

Importante

Se você ainda não associou seu ASN e assinatura, siga as etapas em ASN de par associado. Esta ação é necessária para solicitar um emparelhamento.

Nota

O local de um grupo de recursos é independente do local onde você escolhe configurar um emparelhamento.  

Registre-se para o provedor de recursos de emparelhamento

Registre-se para emparelhar o provedor de recursos em sua assinatura usando Register-AzResourceProvider. Se você não executar isso, os recursos do Azure necessários para configurar o emparelhamento não estarão acessíveis.

Register-AzResourceProvider -ProviderNamespace Microsoft.Peering

Você pode verificar o status do registro usando Get-AzResourceProvider:

Get-AzResourceProvider -ProviderNamespace Microsoft.Peering

Importante

Aguarde até que RegistrationState vire "Registered" antes de prosseguir. Pode demorar 5 a 30 minutos depois de executar o comando.

Atualizar as informações de pares associadas a esta subscrição

Atualize as informações de mesmo nível associadas a esta assinatura usando New-AzPeerAsn:

$contactDetails = New-AzPeerAsnContactDetail -Role Noc -Email "noc@contoso.com" -Phone "+1 (555) 555-5555"
New-AzPeerAsn -Name "Contoso_1234" -PeerName "Contoso" -PeerAsn 1234 -ContactDetail $contactDetails

Nota

-Name corresponde ao nome do recurso e pode ser qualquer coisa que você escolher. No entanto, -peerName corresponde ao nome da sua empresa e precisa estar o mais próximo possível do seu perfil PeeringDB. Observe que o valor para -peerName suporta apenas caracteres a-z, A-Z e espaço.

Uma assinatura pode ter vários ASNs. Atualize as informações de emparelhamento para cada ASN. Certifique-se de que o "nome" seja exclusivo para cada ASN.

Espera-se que os pares tenham um perfil completo e atualizado no PeeringDB. Usamos essas informações durante o registro para validar os detalhes do colega, como informações de NOC, informações de contato técnico e sua presença nas instalações de peering, etc.

No lugar de {subscriptionId} na saída, o ID de assinatura real é exibido.

Exibir status de um PeerASN

Verifique o estado de validação ASN usando Get-AzPeerAsn:

Get-AzPeerAsn

Abaixo está um exemplo de resposta:

PeerContactInfo : Microsoft.Azure.PowerShell.Cmdlets.Peering.Models.PSContactInfo
PeerName        : Contoso
ValidationState : Approved
PeerAsnProperty : 1234
Name            : Contoso_1234
Id              : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/Contoso_1234
Type            : Microsoft.Peering/peerAsns

Importante

Aguarde até que o ValidationState vire "Approved" antes de enviar uma solicitação de emparelhamento. Esta aprovação pode demorar até 12 horas.

Modificar PeerAsn

Você pode modificar as informações de contato do NOC a qualquer momento usando Set-AzPeerAsn:

Set-AzPeerAsn -Name Contoso_1234 -Email "newemail@test.com" -Phone "1800-000-0000"

Excluir PeerAsn

Atualmente, não há suporte para a exclusão de um PeerASN. Se você precisar excluir PeerASN, entre em contato com o emparelhamento da Microsoft.

Próximos passos