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
- Przed rozpoczęciem konfiguracji zapoznaj się z wymaganiami wstępnymi i przewodnikiem komunikacji równorzędnej programu Exchange.
- Jeśli masz już komunikację równorzędną programu Exchange z firmą Microsoft, które nie są konwertowane na zasoby platformy Azure, zobacz Konwertowanie starszej komunikacji równorzędnej programu Exchange 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 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.
Zainstaluj i zaimportuj moduł Az.
Install-Module Az -AllowClobber Import-Module AzZainstaluj i zaimportuj moduł Az.Peering.
Install-Module -Name Az.Peering -AllowClobber Import-Module Az.PeeringSprawdź, czy moduły zaimportowane prawidłowo przy użyciu tego polecenia:
Get-ModuleZaloguj się do konta platformy Azure przy użyciu tego polecenia:
Connect-AzAccountSprawdź subskrypcje konta i wybierz subskrypcję, w której chcesz utworzyć komunikację równorzędną.
Get-AzSubscription Select-AzSubscription -SubscriptionId "subscription-id"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