Compartilhar via

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

  • Artigo

O Serviço de Emparelhamento do Azure é um serviço de rede que aprimora a conectividade com os serviços em nuvem da Microsoft, como o Microsoft 365, o Dynamics 365, os serviços de SaaS (software como serviço), o Azure ou qualquer serviço da Microsoft acessível pela Internet pública.

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

Pré-requisitos

  • Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.

  • Azure Cloud Shell ou Azure PowerShell instalado localmente.

    As etapas desse artigo executam os cmdlets do Azure PowerShell interativamente no Azure Cloud Shell. Para executar os comandos no Cloud Shell, selecione Abrir o 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 no portal do Azure.

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

  • Um provedor de conectividade. Para obter mais informações, confira Parceiros do Serviço de Emparelhamento.

Registrar uma assinatura com o provedor de recursos e o sinalizador de recursos

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 do Serviço de Emparelhamento

Use Get-AzPeeringServiceCountry para listar os países/as regiões em que o Serviço de Emparelhamento está disponível e Get-AzPeeringServiceLocation para listar as áreas metropolitanas disponíveis em cada país/região em que 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
Get-AzPeeringServiceLocation -Country "United States"

Use Get-AzPeeringServiceProvider para obter uma lista de provedores de Serviço de Emparelhamento disponíveis:

Get-AzPeeringServiceProvider

Criar uma conexão do Serviço de Emparelhamento

Crie uma conexão do 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 a você 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 dos 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údo relacionado