Erstellen oder Ändern eines Exchange Peerings mithilfe von PowerShell
In diesem Artikel wird beschrieben, wie Sie mit PowerShell-Cmdlets und dem Resource Manager-Bereitstellungsmodell ein Exchange Peering mit Microsoft erstellen. Der Artikel veranschaulicht auch, wie Sie den Status der Ressource prüfen und die Ressource aktualisieren, löschen oder ihre Bereitstellung aufheben.
Sie können diese Anleitung auch im Azure-Portal durchführen, wenn Sie das vorziehen.
Voraussetzungen
- Lesen Sie vor dem Konfigurieren die Informationen zu den Voraussetzungen sowie die Exemplarische Vorgehensweise für das Exchange Peering.
- Falls Sie bereits Exchange Peerings mit Microsoft eingerichtet haben, die nicht in Azure-Ressourcen konvertiert werden, lesen Sie die Informationen unter Konvertieren eines Legacy-Exchange Peerings in eine Azure-Ressource mithilfe von PowerShell.
Arbeiten mit Azure PowerShell
Um die Cmdlets auszuführen, können Sie Azure Cloud Shell verwenden, eine kostenlose interaktive Shell. Sie verfügt über allgemeine vorinstallierte Tools und ist für die Verwendung mit Ihrem Konto konfiguriert. Wählen Sie Kopieren aus, um den Code zu kopieren, und fügen Sie ihn in Cloud Shell ein. Drücken Sie dann die EINGABETASTE, um ihn auszuführen. Cloud Shell kann auf mehrere Arten gestartet werden:
| Startmethode | Screenshot |
|---|---|
| Öffnen Sie Cloud Shell in Ihrem Browser. |  |
| Wählen Sie die Schaltfläche Cloud Shell auf der Symbolleiste rechts oben im Azure-Portal aus. |  |
Wenn Sie Azure Cloud Shell nicht verwenden möchten, können Sie PowerShell lokal installieren. Wenn Sie PowerShell lokal installieren und verwenden möchten, müssen Sie die aktuelle Version der PowerShell-Cmdlets für Azure Resource Manager installieren. PowerShell-Cmdlets werden regelmäßig aktualisiert. Sie müssen Ihre PowerShell-Cmdlets in der Regel aktualisieren, um die neuesten Features und Funktionen nutzen zu können. Andernfalls treten möglicherweise Probleme auf.
Um die Version von PowerShell zu ermitteln, die Sie lokal ausführen, verwenden Sie das Cmdlet Get-Module -ListAvailable Az. Informationen zum Aktualisieren finden Sie unter Installieren des Azure PowerShell-Moduls. Weitere Informationen finden Sie unter Installieren und Konfigurieren von Azure PowerShell.
Wenn Sie PowerShell unter macOS verwenden, befolgen Sie die Schritte unter Installieren von PowerShell unter macOS.
Erstellen und Bereitstellen eines Exchange Peerings
Melden Sie sich bei Ihrem Azure-Konto an, und wählen Sie Ihr Abonnement aus.
Bevor Sie mit der Konfiguration beginnen, installieren und importieren Sie die erforderlichen Module. Zum Installieren der Module in PowerShell benötigen Sie Administratorberechtigungen.
Installieren und importieren Sie das Az-Modul.
Install-Module Az -AllowClobber Import-Module AzInstallieren und importieren Sie das Az.Peering-Modul.
Install-Module -Name Az.Peering -AllowClobber Import-Module Az.PeeringÜberprüfen Sie mithilfe des folgenden Befehls, ob die Module ordnungsgemäß importiert wurden:
Get-ModuleMelden Sie sich mit diesem Befehl bei Ihrem Azure-Konto an:
Connect-AzAccountSehen Sie sich die Abonnements für das Konto an, und wählen Sie das Abonnement aus, in dem Sie ein Peering erstellen möchten.
Get-AzSubscription Select-AzSubscription -SubscriptionId "subscription-id"Wenn Sie noch keine Ressourcengruppe besitzen, müssen Sie zuerst eine erstellen, bevor Sie ein Peering erstellen. Dazu können Sie den folgenden Befehl ausführen:
New-AzResourceGroup -Name "PeeringResourceGroup" -Location "Central US"
Wichtig
Wenn Sie Ihre ASN und Ihr Abonnement noch nicht zugeordnet haben, führen Sie die Schritte zum Zuordnen einer Peer-ASN aus. Diese Aktion ist erforderlich, um ein Peering anzufordern.
Hinweis
Der Speicherort einer Ressourcengruppe ist unabhängig vom Speicherort, an dem Sie ein Peering einrichten möchten.
Abrufen der Liste mit unterstützten Peeringstandorten für Exchange Peering
Das PowerShell-Cmdlet Get-AzPeeringLocation gibt mit dem obligatorischen Parameter Kind eine Liste der Peeringstandorte zurück, die Sie in späteren Schritten verwenden.
Get-AzPeeringLocation -Kind "Exchange"
Exchange-Peeringstandorte enthalten die folgenden Felder:
- ExchangeName
- PeeringLocation
- Land / Region
- PeeringDBFacilityId
- PeeringDBFacilityLink
- MicrosoftIPv4Address
- MicrosoftIPv6Address
Überprüfen Sie anhand von PeeringDB, ob Sie in der gewünschten Peeringeinrichtung vorhanden sind.
In diesem Beispiel wird gezeigt, wie Sie Seattle als Peeringstandort zum Erstellen eines Peerings verwenden.
$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
...
Erstellen eines Exchange Peerings
Im folgenden Beispiel wird das Erstellen einer Exchange-Verbindung bei Equinix Internet Exchange in Seattle gezeigt. Wenn Sie einen anderen Anbieter und andere Einstellungen verwenden, ersetzen Sie bei Ihrer Anforderung die entsprechenden Informationen.
Verwenden Sie das PowerShell-Cmdlet New-AzPeeringExchangeConnectionObject, um PowerShell-Verbindungsobjekte zu erstellen, die zum Generieren der neuen Peeringanforderung verwendet werden.
In diesem Beispiel wird veranschaulicht, wie eine Exchange-Verbindung erstellt wird.
$connection1 = New-AzPeeringExchangeConnectionObject `
-PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
-PeerSessionIPv4Address 198.32.134.22 `
-PeerSessionIPv6Address 2001:504:12::22 `
-MaxPrefixesAdvertisedIPv4 2000 `
-MaxPrefixesAdvertisedIPv6 2000 `
Erstellen Sie eine weitere Verbindung, falls Redundanz am jeweiligen Peeringstandort erforderlich ist.
$connection2 = New-AzPeeringExchangeConnectionObject `
-PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
-PeerSessionIPv4Address 198.32.134.23 `
-PeerSessionIPv6Address 2001:504:12::23 `
-MaxPrefixesAdvertisedIPv4 2000 `
-MaxPrefixesAdvertisedIPv6 2000 `
Das PowerShell-Cmdlet New-AzPeering kann verwendet werden, um eine neue Exchange Peeringverbindung zu erstellen.
$asn = Get-AzPeerAsn
New-AzPeering `
-Name "SeattleExchangePeering" `
-ResourceGroupName "PeeringResourceGroup" `
-PeerAsnResourceId $asn.Id `
-PeeringLocation $exchangeLocation[1].PeeringLocation `
-ExchangeConnection $connection1[, $connection2]
Dieses Beispiel zeigt die Antwort auf eine Anforderung, die mithilfe einer Verbindung ausgeführt wurde.
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 : {}
Wichtig
Microsoft beginnt mit der Bereitstellung des angeforderten Peerings, und der ConnectionState gibt den Fortschritt wieder.
In der Exemplarischen Vorgehensweise für Exchange-Peering finden Sie Informationen zu den Bereitstellungsschritten.
Sie können den Verbindungsstatus wie hier gezeigt überprüfen.
$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 :
Einrichten von Exchange Peering
Führen Sie zum Abrufen der Liste der Peerings den Befehl Get-AzPeering aus.
Get-AzPeering ResourceGroupName "PeeringResourceGroup" -Name "SeattleExchangePeering"
Diese Beispielantwort wird angezeigt, wenn die End-to-End-Bereitstellung erfolgreich abgeschlossen wurde.
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
Ändern eines Austauschpeerings
Die folgenden Änderungsvorgänge werden für Exchange-Peeringverbindungen unterstützt:
- Hinzufügen von Exchange-Peeringverbindungen
- Entfernen von Exchange-Peeringverbindungen
- Hinzufügen von IPv4-/IPv6-Sitzungen in aktiven Verbindungen
- Entfernen von IPv4-/IPv6-Sitzungen aus aktiven Verbindungen
Hinzufügen von Exchange Peering-Verbindungen
In diesem Beispiel wird beschrieben, wie Sie einem vorhandenen Exchange-Peering Verbindungen hinzufügen.
$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
Entfernen von Exchange Peering-Verbindungen
In diesem Beispiel wird beschrieben, wie Sie Verbindungen aus einem vorhandenen Exchange-Peering entfernen.
$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
Zeigen Sie alle Verbindungen an, und wählen Sie die Verbindung aus, die Sie entfernen möchten.
$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 : {}
Geben Sie im folgenden Befehl anstelle von „0“ die Indexnummer der Verbindung ein, die Sie entfernen möchten.
$connection = $exchangePeering.Connections[0]
$exchangePeering.Connections.Remove($connection)
$exchangePeering | Update-AzPeering
Hinzufügen von IPv4-/IPv6-Sitzungen in aktiven Verbindungen
In diesem Beispiel wird beschrieben, wie Sie einer vorhandenen Exchange-Verbindung eine IPv6-Sitzung hinzufügen.
$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
$exchangePeering.Connections[0].BgpSession.PeerSessionIPv6Address = "2001:504:12::34"
$exchangePeering | Update-AzPeering
Entfernen von IPv4-/IPv6-Sitzungen aus aktiven Verbindungen
Das Entfernen einer IPv4-/IPv6-Sitzung aus einer vorhandenen Verbindung wird mit PowerShell derzeit nicht unterstützt. Wenden Sie sich für weitere Informationen an das Microsoft-Peering-Team.
Aufheben der Bereitstellung eines Exchange Peerings
Die Aufhebung der Bereitstellung über das Azure-Portal oder PowerShell wird derzeit nicht unterstützt. Wenden Sie sich zum Aufheben des Peerings an das Microsoft-Peering-Team.
Zusätzliche Ressourcen
Ausführliche Beschreibungen aller Parameter erhalten Sie, wenn Sie den folgenden Befehl ausführen:
Get-Help Get-AzPeering -detailed