Dela via

Skapa eller ändra en Exchange-peering med hjälp av PowerShell

  • Artikel

Den här artikeln beskriver hur du skapar en Microsoft Exchange-peering med hjälp av PowerShell-cmdletar och Resource Manager-distributionsmodellen. Den här artikeln visar också hur du kontrollerar resursens status, uppdaterar den eller tar bort och avetabler den.

Om du vill kan du slutföra den här guiden med hjälp av Azure Portal.

Innan du börjar

Arbeta med Azure PowerShell

Om du vill köra cmdletarna kan du använda Azure Cloud Shell, ett kostnadsfritt interaktivt gränssnitt. Den har vanliga Azure-verktyg förinstallerat och har konfigurerats för användning med ditt konto. Välj Kopiera för att kopiera koden och klistra in den i Cloud Shell. Välj sedan Retur för att köra det. Det finns några sätt att starta Cloud Shell:

Startmetod Skärmbild
Öppna Cloud Shell i din webbläsare. https://shell.azure.com/powershell
Välj cloud shell-knappen i verktygsfältet längst upp till höger i Azure Portal. Cloud Shell på portalen

Om du inte vill använda Azure Cloud Shell kan du installera PowerShell lokalt i stället. Om du väljer att installera och använda PowerShell lokalt måste du installera den senaste versionen av Azure Resource Manager PowerShell-cmdletarna. PowerShell-cmdletar uppdateras ofta. Du behöver vanligtvis uppdatera dina PowerShell-cmdletar för att få de senaste funktionsfunktionerna. Om du inte gör det kan det uppstå problem.

Om du vill hitta den version av PowerShell som du kör lokalt använder du cmdleten "Get-Module -ListAvailable Az" . Information om hur du uppdaterar finns i Installera Azure PowerShell-modulen. Mer information finns i installera och konfigurera Azure PowerShell.

Om du använder PowerShell på macOS följer du stegen i Installera PowerShell på macOS.

Skapa och etablera en Exchange-peering

Logga in på ditt Azure-konto och välj din prenumeration

Innan du påbörjar konfigurationen installerar och importerar du de moduler som krävs. Du behöver administratörsbehörighet för att installera moduler i PowerShell.

  1. Installera och importera Az-modulen.

    Install-Module Az -AllowClobber
Import-Module Az

  2. Installera och importera Az.Peering-modulen.

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

  3. Kontrollera att modulerna har importerats korrekt med hjälp av det här kommandot:

    Get-Module

  4. Logga in på ditt Azure-konto med det här kommandot:

    Connect-AzAccount

  5. Kontrollera prenumerationerna för kontot och välj den prenumeration där du vill skapa en peering.

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

  6. Om du inte redan har en resursgrupp måste du skapa en innan du skapar en peering. Du kan göra det genom att köra följande kommando:

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

Viktigt!

Om du inte redan har associerat ditt ASN och din prenumeration följer du stegen i Associera peer-ASN. Den här åtgärden krävs för att begära en peering.

Kommentar

Platsen för en resursgrupp är oberoende av den plats där du väljer att konfigurera en peering.  

Hämta listan över peeringplatser som stöds för Exchange-peering

PowerShell-cmdleten Get-AzPeeringLocation returnerar en lista över peeringplatser med den obligatoriska parametern Kind, som du ska använda i senare steg.

Get-AzPeeringLocation -Kind "Exchange"

Exchange-peeringplatser innehåller följande fält:

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

Kontrollera att du är närvarande vid önskad peering-anläggning genom att referera till PeeringDB.

Det här exemplet visar hur du använder Seattle som peeringplats för att skapa en peering.

$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

...

Skapa en Exchange-peering

I följande exempel visas hur du skapar en Exchange-anslutning på Equinix Internet Exchange i Seattle. Om du använder en annan provider och olika inställningar ersätter du den informationen när du gör din begäran.

Använd PowerShell-cmdleten New-AzPeeringExchangeConnectionObject för att skapa PowerShell-anslutningsobjekt, som ska användas för att generera den nya peering-begäran.

Det här exemplet visar hur du skapar en Exchange-anslutning.

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

Skapa en annan anslutning om du behöver redundans på den angivna peeringplatsen.

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

PowerShell-cmdleten New-AzPeering kan användas för att skapa en ny Exchange-peering.

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

 

Det här exempelsvaret visar när begäran kördes med hjälp av en anslutning.


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

Viktigt!

Microsoft börjar etablera den begärda peeringen och ConnectionState visar förloppet. Mer information om etableringsrelaterade steg finns i genomgången av Exchange-peering.

Du kan kontrollera anslutningstillståndet, som du ser här.


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

Hämta Exchange-peering

Hämta listan över peerings genom att köra kommandot Get-AzPeering .

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

Det här exempelsvaret visar när etableringen från slutpunkt till slutpunkt slutfördes.

    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

Ändra en Exchange-peering

Följande ändringsåtgärder stöds för Exchange-peering:

  • Lägg till Exchange-peeringanslutningar.
  • Ta bort Exchange-peeringanslutningar.
  • Lägg till en IPv4- eller IPv6-session på aktiva anslutningar.
  • Ta bort en IPv4- eller IPv6-session på aktiva anslutningar.

Lägga till Exchange-peeringanslutningar

I det här exemplet beskrivs hur du lägger till anslutningar till en befintlig 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

Ta bort Exchange-peeringanslutningar

I det här exemplet beskrivs hur du tar bort anslutningar till en befintlig Exchange-peering.


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

Visa alla anslutningar och välj den anslutning som du vill ta bort.


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

I följande kommando, i stället för 0, anger du indexnumret för den anslutning som du vill ta bort.


$connection = $exchangePeering.Connections[0]

$exchangePeering.Connections.Remove($connection)

$exchangePeering | Update-AzPeering

Lägga till en IPv4- eller IPv6-session på aktiva anslutningar

I det här exemplet beskrivs hur du lägger till en IPv6-session i en befintlig Exchange-anslutning.


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

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

$exchangePeering | Update-AzPeering

Ta bort en IPv4- eller IPv6-session på aktiva anslutningar

Det går för närvarande inte att ta bort en IPv4- eller IPv6-session från en befintlig anslutning i PowerShell. Kontakta Microsoft-peering om du vill ha mer information.

Avetablera en Exchange-peering

För närvarande stöds inte avetablering med hjälp av Azure Portal eller PowerShell. Kontakta Microsoft-peering om du vill avetablera.

Ytterligare resurser

Du kan få detaljerade beskrivningar av alla parametrar genom att köra följande kommando:

Get-Help Get-AzPeering -detailed

Nästa steg