Tworzenie lub modyfikowanie bezpośredniej komunikacji równorzędnej przy użyciu programu PowerShell

• Witryna Azure Portal
• Program PowerShell

W tym artykule opisano sposób tworzenia komunikacji równorzędnej microsoft Direct przy użyciu poleceń cmdlet programu PowerShell i modelu wdrażania usługi Azure Resource Manager. W tym artykule pokazano również, jak sprawdzić stan zasobu, zaktualizować go lub usunąć i usunąć jego aprowizowanie.

Jeśli wolisz, możesz wykonać ten przewodnik, korzystając z witryny Azure Portal.

Zanim rozpoczniesz

• Przed rozpoczęciem konfiguracji zapoznaj się z wymaganiami wstępnymi i przewodnikiem bezpośredniej komunikacji równorzędnej.
• Jeśli masz już bezpośrednie połączenia komunikacji równorzędnej z firmą Microsoft, które nie są konwertowane na zasoby platformy Azure, zobacz Konwertowanie starszej bezpośredniej komunikacji równorzędnej na zasób platformy Azure przy użyciu programu PowerShell.

Praca z programem Azure PowerShell

Aby uruchomić polecenia cmdlet, możesz użyć usługi Azure Cloud Shell, bezpłatnej interaktywnej powłoki. Udostępnia ona wstępnie zainstalowane i najczęściej używane narzędzia platformy Azure, które są skonfigurowane do użycia na koncie. Wybierz pozycję Kopiuj , aby skopiować kod i wklej go w usłudze Cloud Shell. Następnie wybierz Enter , aby go uruchomić. Istnieje kilka sposobów uruchamiania usługi Cloud Shell:

Launch, metoda	Zrzut ekranu
Otwórz usługę Cloud Shell w swojej przeglądarce.
Wybierz przycisk Cloud Shell na pasku narzędzi w prawym górnym rogu witryny Azure Portal.

Jeśli nie chcesz używać usługi Azure Cloud Shell, możesz zainstalować program PowerShell lokalnie. Jeśli zdecydujesz się zainstalować program PowerShell i używać go lokalnie, zainstaluj najnowszą wersję poleceń cmdlet programu PowerShell usługi Azure Resource Manager. Polecenia cmdlet programu PowerShell są często aktualizowane. Zazwyczaj należy zaktualizować polecenia cmdlet programu PowerShell, aby uzyskać najnowsze funkcje funkcji. Jeśli tego nie zrobisz, mogą wystąpić problemy.

Aby znaleźć wersję programu PowerShell, która jest uruchomiona lokalnie, użyj polecenia cmdlet "Get-Module -ListAvailable Az". Aby przeprowadzić aktualizację, zobacz Instalowanie modułu programu Azure PowerShell. Aby uzyskać więcej informacji, zobacz instalowanie i konfigurowanie programu Azure PowerShell.

Jeśli używasz programu PowerShell w systemie macOS, wykonaj kroki opisane w temacie Instalowanie programu PowerShell w systemie macOS.

Tworzenie i aprowizowanie bezpośredniej komunikacji równorzędnej

Zaloguj się do konta platformy Azure i wybierz swoją subskrypcję

Przed rozpoczęciem konfiguracji zainstaluj i zaimportuj wymagane moduły. Aby zainstalować moduły w programie PowerShell, potrzebne są uprawnienia administratora.

1. Zainstaluj i zaimportuj moduł Az.

   Install-Module Az -AllowClobber
   Import-Module Az
   

2. Zainstaluj i zaimportuj moduł Az.Peering.

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

3. Sprawdź, czy moduły zaimportowane prawidłowo przy użyciu tego polecenia:

   Get-Module
   

4. Zaloguj się do konta platformy Azure przy użyciu tego polecenia:

   Connect-AzAccount
   

5. Sprawdź subskrypcje konta i wybierz subskrypcję, w której chcesz utworzyć komunikację równorzędną.

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

6. Jeśli nie masz jeszcze grupy zasobów, musisz go utworzyć przed utworzeniem komunikacji równorzędnej. Możesz to zrobić, uruchamiając następujące polecenie:

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

Ważne

Jeśli nie skojarzono jeszcze usługi ASN i subskrypcji, wykonaj kroki opisane w artykule Kojarzenie równorzędnej nazwy ASN. Ta akcja jest wymagana do żądania komunikacji równorzędnej.

Uwaga

Lokalizacja grupy zasobów jest niezależna od lokalizacji, w której chcesz skonfigurować komunikację równorzędną.  

Pobieranie listy obsługiwanych lokalizacji komunikacji równorzędnej dla bezpośredniej komunikacji równorzędnej

Polecenie cmdlet programu PowerShell Get-AzPeeringLocation zwraca listę lokalizacji komunikacji równorzędnej z obowiązkowym parametrem Kind, który zostanie użyty w kolejnych krokach.

Get-AzPeeringLocation -Kind Direct

Bezpośrednie lokalizacje komunikacji równorzędnej zawierają następujące pola:

• Komunikacja równorzędnaLokalizacja
• Kraj
• PeeringDBFacilityId
• Komunikacja równorzędnaDBFacilityLink
• PrzepustowośćOffers

Sprawdź, czy jesteś obecny w żądanym obiekcie komunikacji równorzędnej, odwołując się do usługi PeeringDB.

W tym przykładzie pokazano, jak używać Seattle jako lokalizacji komunikacji równorzędnej w celu utworzenia bezpośredniej komunikacji równorzędnej.

$peeringLocations = Get-AzPeeringLocation -Kind Direct
$peeringLocation = $peeringLocations | where {$_.PeeringLocation -contains "Seattle"}
$peeringLocation

PeeringLocation       : Seattle
Address               : 2001 Sixth Avenue
Country               : US
PeeringDBFacilityId   : 71
PeeringDBFacilityLink : https://www.peeringdb.com/fac/71
BandwidthOffers       : {10Gbps, 100Gbps}

Tworzenie bezpośredniej komunikacji równorzędnej

W poniższym przykładzie pokazano, jak utworzyć komunikację równorzędną 10 Gb/s Direct w Seattle.

Użyj polecenia cmdlet programu PowerShell New-AzPeeringDirectConnectionObject , aby utworzyć obiekty DirectConnection, które mają być używane w nowym żądaniu komunikacji równorzędnej.

W tym przykładzie pokazano, jak utworzyć obiekt DirectConnection.

$connection1 = New-AzPeeringDirectConnectionObject `
    -PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
    -SessionPrefixV4 10.21.31.0/31 `
    -SessionPrefixV6 fe01::3e:0/127 `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

Uwaga

Wartość $peeringLocation[] w poprzednim przykładzie powinna odpowiadać wybranej lokalizacji komunikacji równorzędnej.

Utwórz inne połączenie, jeśli potrzebujesz nadmiarowości w danej lokalizacji komunikacji równorzędnej.

$connection2 = New-AzPeeringDirectConnectionObject `
    -PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
    -SessionPrefixV4 10.21.33.0/31 `
    -SessionPrefixV6 fe01::3f:0/127 `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

Użyj polecenia cmdlet programu PowerShell New-AzPeering , aby utworzyć nową bezpośrednią komunikację równorzędną. To polecenie wymaga identyfikatora zasobu ASN, który można pobrać, jak pokazano tutaj.

$asn = Get-AzPeerAsn
New-AzPeering `
    -Name "SeattleDirectPeering" `
    -ResourceGroupName "PeeringResourceGroup" `
    -PeeringLocation  $peeringLocation[0].PeeringLocation `
    -PeerAsnResourceId $asn.Id `
    -DirectConnection $connection1 [, $connection2]

 

W tym przykładzie pokazano odpowiedź, kiedy żądanie zostało pomyślnie przetworzone.

    Name                 : SeattleDirectPeering
    Sku.Name             : Basic_Direct_Free
    Kind                 : Direct
    Connections          : 71
    PeerAsn.Id           : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/SeattleDirectPeering
    UseForPeeringService : False
    PeeringLocation      : Seattle
    ProvisioningState    : Succeeded
    Location             : centralus
    Id                   : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
    Type                 : Microsoft.Peering/peerings
    Tags                 : {}

Pamiętaj, że zamiast {subscriptionId} w tych danych wyjściowych zostanie wyświetlony rzeczywisty identyfikator subskrypcji.

Weryfikowanie bezpośredniej komunikacji równorzędnej

Aby uzyskać listę komunikacji równorzędnej, uruchom polecenie Get-AzPeering .

$directPeering = Get-AzPeering -ResourceGroupName "PeeringResourceGroup" -Name "SeattleDirectPeering"

W poniższym przykładzie przedstawiono odpowiedź po pomyślnym zakończeniu kompleksowej aprowizacji.

    Name                 : SeattleDirectPeering
    Sku.Name             : Basic_Direct_Free
    Kind                 : Direct
    Connections          : {71}
    PeerAsn.Id           : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/SeattleDirectPeering
    UseForPeeringService : False
    PeeringLocation      : Seattle
    ProvisioningState    : Succeeded
    Location             : centralus
    Id                   : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
    Type                 : Microsoft.Peering/peerings
    Tags                 : {}

Modyfikowanie bezpośredniej komunikacji równorzędnej

W tej sekcji opisano sposób wykonywania następujących operacji modyfikacji dla bezpośredniej komunikacji równorzędnej:

• Dodaj bezpośrednie połączenia komunikacji równorzędnej.
• Usuń bezpośrednie połączenia komunikacji równorzędnej.
• Podwyższanie lub obniżanie przepustowości w przypadku aktywnych połączeń.
• Dodaj sesje IPv4 lub IPv6 w aktywnych połączeniach.
• Usuń sesje IPv4 lub IPv6 w aktywnych połączeniach.

Dodawanie połączeń bezpośredniej komunikacji równorzędnej

W tym przykładzie opisano sposób dodawania połączeń do istniejącej bezpośredniej komunikacji równorzędnej.

$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"

$connection = New-AzPeeringDirectConnection `
    -PeeringDBFacilityId $peeringLocation.PeeringDBFacilityId `
    -SessionPrefixV4 "10.22.31.0/31" `
    -SessionPrefixV6 "fe02::3e:0/127" `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

$directPeering.Connections.Add($connection)

$directPeering | Update-AzPeering

Usuwanie bezpośrednich połączeń komunikacji równorzędnej

Usuwanie połączenia nie jest obecnie obsługiwane w programie PowerShell. Aby uzyskać więcej informacji, skontaktuj się z komunikacją równorzędną firmy Microsoft.

Uaktualnianie lub obniżanie przepustowości w przypadku aktywnych połączeń

W tym przykładzie opisano sposób dodawania 10 Gb/s do istniejącego połączenia bezpośredniego.

$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BandwidthInMbps  = 20000
$directPeering | Update-AzPeering

Dodawanie sesji IPv4 lub IPv6 w przypadku aktywnych połączeń

W tym przykładzie opisano sposób dodawania sesji IPv6 do istniejącego połączenia bezpośredniego tylko z sesją IPv4.

$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BGPSession.SessionPrefixv6 = "fe01::3e:0/127"
$directPeering | Update-AzPeering

Usuwanie sesji IPv4 lub IPv6 w aktywnych połączeniach

Usunięcie sesji IPv4 lub IPv6 z istniejącego połączenia nie jest obecnie obsługiwane w programie PowerShell. Aby uzyskać więcej informacji, skontaktuj się z komunikacją równorzędną firmy Microsoft.

Anulowanie aprowizacji bezpośredniej komunikacji równorzędnej

Obecnie anulowanie aprowizacji nie jest obsługiwane przy użyciu witryny Azure Portal ani programu PowerShell. Aby usunąć aprowizowanie, skontaktuj się z komunikacją równorzędną firmy Microsoft.

Dodatkowe zasoby

Szczegółowe opisy wszystkich parametrów można uzyskać, uruchamiając następujące polecenie:

Get-Help Get-AzPeering -detailed

Następne kroki

• Utwórz lub zmodyfikuj komunikację równorzędną programu Exchange przy użyciu programu PowerShell.
• Przekonwertuj starszą komunikację równorzędną programu Exchange na zasób platformy Azure przy użyciu programu PowerShell.
• Często zadawane pytania dotyczące komunikacji równorzędnej z Internetem.