Partilhar via

Criar ou alterar uma conexão de Serviço de Emparelhamento usando o PowerShell

  • Artigo

O Serviço de Emparelhamento do Azure é um serviço de rede que melhora a conectividade com serviços de nuvem da Microsoft, como Microsoft 365, Dynamics 365, serviços de software como serviço (SaaS), Azure ou quaisquer serviços da Microsoft acessíveis através da Internet pública.

Neste artigo, você aprenderá a criar e alterar uma conexão de Serviço de Emparelhamento usando o Azure PowerShell. Para saber como gerenciar uma conexão de Serviço de Emparelhamento usando o portal do Azure ou a CLI do Azure, consulte Criar, alterar ou excluir uma conexão de Serviço de Emparelhamento usando o portal do Azure ou Criar, alterar ou excluir uma conexão de Serviço de Emparelhamento usando a CLI do Azure.

Pré-requisitos

  • Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.

  • Azure Cloud Shell ou Azure PowerShell instalado localmente.

    As etapas neste artigo executam os cmdlets do Azure PowerShell interativamente no Azure Cloud Shell. Para executar os comandos no Cloud Shell, selecione Abrir Cloudshell no canto superior direito de um bloco de código. Selecione Copiar para copiar o código e cole-o no Cloud Shell para executá-lo. Você também pode executar o Cloud Shell de dentro do portal do Azure.

    Você também pode instalar o Azure PowerShell localmente para executar os cmdlets. Este artigo requer o módulo do Azure PowerShell versão 1.0.0 ou posterior. Para localizar a versão instalada, execute Get-Module -ListAvailable Az. Se precisar de atualizar, veja Install Azure PowerShell module (Instalar o módulo do Azure PowerShell). Se você executar o PowerShell localmente, entre no Azure usando o cmdlet Connect-AzAccount .

  • Um provedor de conectividade. Para obter mais informações, consulte Parceiros de serviço de emparelhamento.

Registe a sua subscrição com o fornecedor de recursos e o sinalizador de funcionalidades

Antes de prosseguir para as etapas de criação do Serviço de Emparelhamento, registre sua assinatura com o provedor de recursos e o sinalizador de recursos usando Register-AzResourceProvider e Register-AzProviderFeature:

# Register Microsoft.Peering provider.
Register-AzResourceProvider -ProviderNamespace Microsoft.Peering
# Register AllowPeeringService feature.
Register-AzProviderFeature -FeatureName AllowPeeringService -ProviderNamespace Microsoft.Peering

Listar locais e provedores de serviços do Serviço de Emparelhamento

Use Get-AzPeeringServiceCountry para listar os países/regiões onde o Serviço de Emparelhamento está disponível e Get-AzPeeringServiceLocation para listar os locais de metrô disponíveis em cada país/região onde você pode obter o Serviço de Emparelhamento:

# List the countries/regions available for Peering Service.
Get-AzPeeringServiceCountry 
# List metro locations serviced in a country/region
Get-AzPeeringServiceLocation -Country "United States"

Use Get-AzPeeringServiceProvider para obter uma lista de provedores de serviços de emparelhamento disponíveis:

Get-AzPeeringServiceProvider

Criar uma conexão de serviço de emparelhamento

Crie uma conexão de serviço de emparelhamento usando New-AzPeeringService:

New-AzPeeringService -ResourceGroupName myResourceGroup -Name myPeeringService -PeeringLocation Virginia -PeeringServiceProvider Contoso

Adicionar o prefixo do Serviço de Emparelhamento

Use New-AzPeeringServicePrefix para adicionar o prefixo fornecido pelo provedor de conectividade:

New-AzPeeringServicePrefix -ResourceGroupName myResourceGroup -PeeringServiceName myPeeringService -Name myPrefix -prefix 240.0.0.0/32 -ServiceKey 00000000-0000-0000-0000-000000000000

Listar todas as conexões de Serviços de Emparelhamento

Para exibir a lista de todas as conexões do Serviço de Emparelhamento, use Get-AzPeeringService:

Get-AzPeeringService | Format-Table Name, PeeringServiceLocation, PeeringServiceProvider, Location

Listar todos os prefixos do Serviço de Emparelhamento

Para exibir a lista de todos os prefixos do Serviço de Emparelhamento, use Get-AzPeeringServicePrefix:

Get-AzPeeringServicePrefix -PeeringServiceName myPeeringService -ResourceGroupName myResourceGroup

Remover o prefixo do Serviço de Emparelhamento

Para remover o prefixo do serviço de emparelhamento, use Remove-AzPeeringServicePrefix:

Remove-AzPeeringServicePrefix -ResourceGroupName myResourceGroup -Name myPeeringService -PrefixName myPrefix

Conteúdos relacionados

  • Para saber mais sobre conexões de serviço de emparelhamento, consulte Conexão de serviço de emparelhamento.
  • Para saber mais sobre a telemetria de conexão do Serviço de Emparelhamento, consulte Telemetria de conexão do Serviço de Emparelhamento de Acesso.