Delen via

Een Exchange-peering maken of wijzigen met behulp van PowerShell

  • Artikel

In dit artikel wordt beschreven hoe u een Microsoft Exchange-peering maakt met behulp van PowerShell-cmdlets en het Resource Manager-implementatiemodel. In dit artikel leest u ook hoe u de status van de resource controleert, de resource bijwerkt of de inrichting ervan ongedaan maakt.

Als u wilt, kunt u deze handleiding voltooien met behulp van Azure Portal.

Voordat u begint

Werken met Azure PowerShell

Als u de cmdlets wilt uitvoeren, kunt u Azure Cloud Shell gebruiken, een gratis interactieve shell. In deze shell zijn algemene Azure-hulpprogramma's vooraf geïnstalleerd en geconfigureerd voor gebruik met uw account. Selecteer Kopiëren om de code te kopiëren en plak deze in Cloud Shell. Selecteer vervolgens Enter om het uit te voeren. Er zijn een aantal manieren om Cloud Shell te starten:

Startmethode Schermafbeelding
Open Cloud Shell in uw browser. https://shell.azure.com/powershell
Selecteer de knop Cloud Shell op de werkbalk in de rechterbovenhoek van Azure Portal. Cloud Shell in de portal

Als u Azure Cloud Shell niet wilt gebruiken, kunt u PowerShell lokaal installeren. Als u PowerShell lokaal wilt installeren en gebruiken, moet u de nieuwste versie van de Azure Resource Manager PowerShell-cmdlets installeren. PowerShell-cmdlets worden regelmatig bijgewerkt. Doorgaans moet u uw PowerShell-cmdlets bijwerken om de nieuwste functiefunctionaliteit te krijgen. Als u dat niet doet, kunnen er problemen optreden.

Gebruik de cmdlet Get-Module -ListAvailable Az om de versie van PowerShell te vinden die u lokaal uitvoert. Zie De Azure PowerShell-module installeren om bij te werken. Zie voor meer informatie hoe u Azure PowerShell installeert en configureert.

Als u PowerShell in macOS gebruikt, volgt u de stappen in Het installeren van PowerShell in macOS.

Een Exchange-peering maken en inrichten

Aanmelden bij uw Azure-account en uw abonnement selecteren

Voordat u met de configuratie begint, moet u de vereiste modules installeren en importeren. U hebt beheerdersbevoegdheden nodig om modules te installeren in PowerShell.

  1. Installeer en importeer de Az-module.

    Install-Module Az -AllowClobber
Import-Module Az

  2. Installeer en importeer de Az.Peering-module.

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

  3. Controleer of de modules correct zijn geïmporteerd met behulp van deze opdracht:

    Get-Module

  4. Meld u aan bij uw Azure-account met behulp van deze opdracht:

    Connect-AzAccount

  5. Controleer de abonnementen voor het account en selecteer het abonnement waarin u een peering wilt maken.

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

  6. Als u nog geen resourcegroep hebt, moet u er een maken voordat u een peering maakt. U doet dit door de volgende opdracht uit te voeren:

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

Belangrijk

Als u uw ASN en abonnement nog niet hebt gekoppeld, volgt u de stappen in Peer ASN koppelen. Deze actie is vereist om een peering aan te vragen.

Notitie

De locatie van een resourcegroep is onafhankelijk van de locatie waar u een peering wilt instellen.  

De lijst met ondersteunde peeringlocaties voor Exchange-peering ophalen

De PowerShell-cmdlet Get-AzPeeringLocation retourneert een lijst met peeringlocaties met de verplichte parameter Kind, die u in latere stappen gaat gebruiken.

Get-AzPeeringLocation -Kind "Exchange"

Exchange-peeringlocaties bevatten de volgende velden:

  • ExchangeName
  • PeeringLocation
  • Land/regio
  • PeeringDBFacilityId
  • PeeringDBFacilityLink
  • MicrosoftIPv4Address
  • MicrosoftIPv6Address

Controleer of u aanwezig bent op de gewenste peeringfaciliteit door te verwijzen naar PeeringDB.

In dit voorbeeld ziet u hoe u Seattle gebruikt als peeringlocatie om een peering te maken.

$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

...

Een Exchange-peering maken

In het volgende voorbeeld ziet u hoe u een Exchange-verbinding maakt bij Equinix Internet Exchange in Seattle. Als u een andere provider en andere instellingen gebruikt, vervangt u deze informatie wanneer u uw aanvraag indient.

Gebruik de PowerShell-cmdlet New-AzPeeringExchangeConnectionObject om PowerShell-verbindingsobjecten te maken, die worden gebruikt om de nieuwe peeringaanvraag te genereren.

In dit voorbeeld ziet u hoe u een Exchange-verbinding maakt.

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

Maak een andere verbinding voor het geval u redundantie nodig hebt op de opgegeven peeringlocatie.

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

De PowerShell-cmdlet New-AzPeering kan worden gebruikt om een nieuwe Exchange-peering te maken.

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

 

In dit voorbeeldantwoord ziet u wanneer de aanvraag is uitgevoerd met behulp van één verbinding.


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              : {}

Belangrijk

Microsoft begint met het inrichten van de aangevraagde peering en ConnectionState geeft de voortgang weer. Zie het overzicht van Exchange-peering voor meer informatie over de stappen die betrekking hebben op het inrichten.

U kunt de verbindingsstatus controleren, zoals hier wordt weergegeven.


$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        :

Exchange-peering ophalen

Voer de opdracht Get-AzPeering uit om de lijst met peerings op te halen.

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

In dit voorbeeldantwoord ziet u wanneer de end-to-end-inrichting is voltooid.

    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

Een Exchange-peering wijzigen

De volgende wijzigingsbewerkingen worden ondersteund voor Exchange-peering:

  • Exchange-peeringverbindingen toevoegen.
  • Verwijder Exchange-peeringverbindingen.
  • Voeg een IPv4- of IPv6-sessie toe aan actieve verbindingen.
  • Verwijder een IPv4- of IPv6-sessie voor actieve verbindingen.

Exchange-peeringverbindingen toevoegen

In dit voorbeeld wordt beschreven hoe u verbindingen toevoegt aan een bestaande Exchange-peering.


$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

Exchange-peeringverbindingen verwijderen

In dit voorbeeld wordt beschreven hoe u verbindingen met een bestaande Exchange-peering verwijdert.


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

Bekijk alle verbindingen en selecteer de verbinding die u wilt verwijderen.


$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              : {}

Voer in de volgende opdracht, in plaats van 0, het indexnummer in voor de verbinding die u wilt verwijderen.


$connection = $exchangePeering.Connections[0]

$exchangePeering.Connections.Remove($connection)

$exchangePeering | Update-AzPeering

Een IPv4- of IPv6-sessie toevoegen aan actieve verbindingen

In dit voorbeeld wordt beschreven hoe u een IPv6-sessie toevoegt aan een bestaande Exchange-verbinding.


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

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

$exchangePeering | Update-AzPeering

Een IPv4- of IPv6-sessie verwijderen voor actieve verbindingen

Het verwijderen van een IPv4- of IPv6-sessie vanuit een bestaande verbinding wordt momenteel niet ondersteund in PowerShell. Neem contact op met Microsoft-peering voor meer informatie.

Inrichting van exchange-peering ongedaan maken

Op dit moment wordt het ongedaan maken van de inrichting niet ondersteund met behulp van Azure Portal of PowerShell. Neem contact op met Microsoft-peering om de inrichting ongedaan te maken.

Aanvullende bronnen

U kunt gedetailleerde beschrijvingen van alle parameters opvragen door de volgende opdracht uit te voeren:

Get-Help Get-AzPeering -detailed

Volgende stappen