Udostępnij za pośrednictwem


Tworzenie lub modyfikowanie komunikacji równorzędnej programu Exchange przy użyciu programu PowerShell

W tym artykule opisano sposób tworzenia komunikacji równorzędnej programu Microsoft Exchange przy użyciu poleceń cmdlet programu PowerShell i modelu wdrażania usługi 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

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. https://shell.azure.com/powershell
Wybierz przycisk Cloud Shell na pasku narzędzi w prawym górnym rogu witryny Azure Portal. Usługa Cloud Shell w portalu

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 komunikacji równorzędnej programu Exchange

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 komunikacji równorzędnej programu Exchange

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 "Exchange"

Lokalizacje komunikacji równorzędnej programu Exchange zawierają następujące pola:

  • ExchangeName
  • Komunikacja równorzędnaLokalizacja
  • Kraj
  • PeeringDBFacilityId
  • Komunikacja równorzędnaDBFacilityLink
  • MicrosoftIPv4Address
  • MicrosoftIPv6Address

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 komunikacji równorzędnej.

$exchangeLocations = Get-AzPeeringLocation -Kind Exchange
$exchangeLocation = $exchangeLocations | where {$_.PeeringLocation -eq "Seattle"}

#check the location metadata
$exchangeLocation

ExchangeName          : Columbia IX
PeeringLocation       : Seattle
Country               : US
PeeringDBFacilityId   : 99999
PeeringDBFacilityLink : https://www.peeringdb.com/ix/99999
MicrosoftIPv4Address  : 10.12.97.129
MicrosoftIPv6Address  :

ExchangeName          : Equinix Seattle
PeeringLocation       : Seattle
Country               : US
PeeringDBFacilityId   : 11
PeeringDBFacilityLink : https://www.peeringdb.com/ix/11
MicrosoftIPv4Address  : 198.32.134.152
MicrosoftIPv6Address  : 2001:504:12::15

...

Tworzenie komunikacji równorzędnej programu Exchange

W poniższym przykładzie pokazano, jak utworzyć połączenie z programem Exchange w aplikacji Equinix Internet Exchange w Seattle. Jeśli używasz innego dostawcy i różnych ustawień, zastąp te informacje podczas tworzenia żądania.

Użyj polecenia cmdlet programu PowerShell New-AzPeeringExchangeConnectionObject , aby utworzyć obiekty połączenia programu PowerShell, które będą używane do generowania nowego żądania komunikacji równorzędnej.

W tym przykładzie pokazano, jak utworzyć połączenie z programem Exchange.

$connection1 = New-AzPeeringExchangeConnectionObject `
    -PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
    -PeerSessionIPv4Address 198.32.134.22 `
    -PeerSessionIPv6Address  2001:504:12::22 `
    -MaxPrefixesAdvertisedIPv4 2000 `
    -MaxPrefixesAdvertisedIPv6 2000 `

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

$connection2 = New-AzPeeringExchangeConnectionObject `
    -PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
    -PeerSessionIPv4Address 198.32.134.23 `
    -PeerSessionIPv6Address  2001:504:12::23 `
    -MaxPrefixesAdvertisedIPv4 2000 `
    -MaxPrefixesAdvertisedIPv6 2000 `

Polecenia cmdlet programu PowerShell New-AzPeering można użyć do utworzenia nowej komunikacji równorzędnej programu Exchange.

$asn = Get-AzPeerAsn
New-AzPeering `
    -Name "SeattleExchangePeering" `
    -ResourceGroupName "PeeringResourceGroup" `
    -PeerAsnResourceId $asn.Id `
    -PeeringLocation  $exchangeLocation[1].PeeringLocation `
    -ExchangeConnection $connection1[, $connection2]

 

Ta przykładowa odpowiedź pokazuje, kiedy żądanie zostało wykonane przy użyciu jednego połączenia.


Name              : SeattleExchangePeering
Sku.Name          : Basic_Exchange_Free
Kind              : Exchange
Connections       : {11}
PeerAsn.Id        : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{peerAsnName}
PeeringLocation   : Seattle
ProvisioningState : Succeeded
Location          : West US 2
Id                : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleExchangePeering
Type              : Microsoft.Peering/peerings
Tags              : {}

Ważne

Firma Microsoft rozpoczyna aprowizację żądanej komunikacji równorzędnej i ConnectionState odzwierciedla postęp. Aby uzyskać więcej informacji na temat kroków związanych z aprowizowaniem, zobacz przewodnik po komunikacji równorzędnej programu Exchange.

Możesz sprawdzić stan połączenia, jak pokazano tutaj.


$peering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
$peering.Connections

PeeringDBFacilityId         : 11
PeerSessionIPv4Address      : 198.32.134.22
PeerSessionIPv6Address      : 2001:504:12::22
SessionStateV4              : PendingAdd
SessionStateV6              : PendingAdd
MaxPrefixesAdvertisedV4     : 2000
MaxPrefixesAdvertisedV6     : 2000
MicrosoftSessionIPv4Address : 198.32.134.152
MicrosoftSessionIPv4Address : 2001:504:12::15
Md5AuthenticationKey        :

Uzyskiwanie komunikacji równorzędnej z programem Exchange

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

Get-AzPeering ResourceGroupName "PeeringResourceGroup" -Name "SeattleExchangePeering"

Ta przykładowa odpowiedź pokazuje, kiedy zakończono kompleksową aprowizację.

    Name                     : SeattleExchangePeering
    Sku                      : Basic_Exchange_Free
    Kind                     : Exchange
    PeeringLocation          : Seattle
    ProvisioningState        : Succeeded
    PeerAsn                  : 65000
    Connection               : ------------------------
    PeerSessionIPv4Address   : 10.21.31.100
    MicrosoftIPv4Address     : 10.21.31.50
    SessionStateV4           : Established
    MaxPrefixesAdvertisedV4  : 20000
    PeerSessionIPv6Address   : fe01::3e:100
    MicrosoftIPv6Address     : fe01::3e:50
    SessionStateV6           : Established
    MaxPrefixesAdvertisedV6  : 2000
    ConnectionState          : Active
    Connection               : ------------------------
    PeerSessionIPv4Address   : 10.21.31.101
    MicrosoftIPv4Address     : 10.21.31.51
    SessionStateV4           : Established
    MaxPrefixesAdvertisedV4  : 20000
    PeerSessionIPv6Address   : fe01::3e:101
    MicrosoftIPv6Address     : fe01::3e:51
    SessionStateV6           : Established
    MaxPrefixesAdvertisedV6  : 2000
    ConnectionState          : Active

Modyfikowanie komunikacji równorzędnej programu Exchange

Następujące operacje modyfikacji są obsługiwane w przypadku komunikacji równorzędnej programu Exchange:

  • Dodaj połączenia komunikacji równorzędnej programu Exchange.
  • Usuń połączenia komunikacji równorzędnej programu Exchange.
  • Dodaj sesję IPv4 lub IPv6 w aktywnych połączeniach.
  • Usuń sesję IPv4 lub IPv6 w aktywnych połączeniach.

Dodawanie połączeń komunikacji równorzędnej programu Exchange

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


$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"

$connection = New-AzPeeringExchangeConnectionObject `
    -PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
    -PeerSessionIPv4Address 198.32.134.22 `
    -PeerSessionIPv6Address  2001:504:12::22 `
    -MaxPrefixesAdvertisedIPv4 2000 `
    -MaxPrefixesAdvertisedIPv6 2000 `

$exchangePeering.Connections.Add($connection)

$exchangePeering | Update-AzPeering

Usuwanie połączeń komunikacji równorzędnej programu Exchange

W tym przykładzie opisano sposób usuwania połączeń z istniejącą komunikacją równorzędną programu Exchange.


$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"

Wyświetl wszystkie połączenia i wybierz połączenie, które chcesz usunąć.


$exchangePeering

Name              : SeattleExchangePeering
Sku.Name          : Basic_Exchange_Free
Kind              : Exchange
Connections       : {11}
PeerAsn.Id        : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{peerAsnName}
PeeringLocation   : Seattle
ProvisioningState : Succeeded
Location          : West US 2
Id                : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleExchangePeering
Type              : Microsoft.Peering/peerings
Tags              : {}

W poniższym poleceniu zamiast 0 wprowadź numer indeksu dla połączenia, które chcesz usunąć.


$connection = $exchangePeering.Connections[0]

$exchangePeering.Connections.Remove($connection)

$exchangePeering | Update-AzPeering

Dodawanie sesji IPv4 lub IPv6 w aktywnych połączeniach

W tym przykładzie opisano sposób dodawania sesji IPv6 do istniejącego połączenia programu Exchange.


$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"

$exchangePeering.Connections[0].BgpSession.PeerSessionIPv6Address = "2001:504:12::34"

$exchangePeering | 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 komunikacji równorzędnej programu Exchange

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