Condividi tramite

Creare o modificare un peering di Exchange con PowerShell

  • Articolo

Questo articolo descrive come creare un peering di Microsoft Exchange usando i cmdlet di PowerShell e il modello di distribuzione Resource Manager. Questo articolo illustra anche come controllare lo stato della risorsa, aggiornarla o eliminarla ed eseguire il deprovisioning.

Se si preferisce, è possibile completare questa guida usando il portale di Azure.

Operazioni preliminari

Usare Azure PowerShell

Per eseguire i cmdlet, è possibile usare Azure Cloud Shell, una shell interattiva gratuita. Include strumenti comuni di Azure preinstallati e configurati per l'uso con l'account. Selezionare Copia per copiare il codice e incollarlo in Cloud Shell. Selezionare quindi Invio per eseguirlo. Esistono alcuni modi per avviare Cloud Shell:

Launch, metodo Schermata
Aprire Cloud Shell nel browser. https://shell.azure.com/powershell
Selezionare il pulsante Cloud Shell sulla barra degli strumenti in alto a destra del portale di Azure. Cloud Shell nel portale

Se non si vuole usare Azure Cloud Shell, è possibile installare PowerShell in locale. Se si sceglie di installare e usare PowerShell in locale, assicurarsi di installare la versione più recente dei cmdlet di PowerShell per Azure Resource Manager. I cmdlet di PowerShell vengono aggiornati di frequente. In genere è necessario aggiornare i cmdlet di PowerShell per ottenere la funzionalità più recente. In caso contrario, potrebbero verificarsi problemi.

Per trovare la versione di PowerShell in esecuzione in locale, usare il cmdlet 'Get-Module -ListAvailable Az' . Per aggiornare, vedere Installare il modulo Azure PowerShell. Per altre informazioni, vedere come installare e configurare Azure PowerShell.

Se si usa PowerShell in macOS, seguire la procedura descritta in Installazione di PowerShell in macOS.

Creare un peering di Exchange ed effettuarne il provisioning

Accedere al proprio account Azure e selezionare la sottoscrizione

Prima di iniziare la configurazione, installare e importare i moduli necessari. Sono necessari privilegi di amministratore per installare i moduli in PowerShell.

  1. Installare e importare il modulo Az.

    Install-Module Az -AllowClobber
Import-Module Az

  2. Installare e importare il modulo Az.Peering.

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

  3. Verificare che i moduli importati correttamente usando questo comando:

    Get-Module

  4. Accedere al proprio account di Azure con il seguente comando:

    Connect-AzAccount

  5. Controllare le sottoscrizioni per l'account e selezionare la sottoscrizione in cui si vuole creare un peering.

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

  6. Se non si ha già un gruppo di risorse, è necessario crearne uno prima di creare un peering. A questo scopo, eseguire il comando seguente:

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

Importante

Se l'ASN e la sottoscrizione non sono già state associate, seguire la procedura descritta in Associare l'ASN peer. Questa azione è necessaria per richiedere un peering.

Nota

La posizione di un gruppo di risorse è indipendente dalla posizione in cui si sceglie di configurare un peering.  

Ottenere l'elenco dei percorsi di peering supportati per il peering di Exchange

Il cmdlet di PowerShell Get-AzPeeringLocation restituisce un elenco di percorsi di peering con il parametro Kindobbligatorio , che verrà usato nei passaggi successivi.

Get-AzPeeringLocation -Kind "Exchange"

I percorsi di peering di Exchange contengono i campi seguenti:

  • ExchangeName
  • PeeringLocation
  • Country
  • PeeringDBFacilityId
  • PeeringDBFacilityLink
  • MicrosoftIPv4Address
  • MicrosoftIPv6Address

Verificare di essere presenti nella struttura di peering desiderata facendo riferimento a PeeringDB.

Questo esempio illustra come usare Seattle come percorso di peering per creare un 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

...

Creare un peering di Exchange

Nell'esempio seguente viene illustrato come creare una connessione exchange in Equinix Internet Exchange a Seattle. Se si usa un altro provider e impostazioni diverse, sostituire tali informazioni al momento della richiesta.

Usare il cmdlet di PowerShell New-AzPeeringExchangeConnectionObject per creare oggetti di connessione di PowerShell, che verranno usati per generare la nuova richiesta di peering.

In questo esempio viene illustrato come creare una connessione di Exchange.

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

Creare un'altra connessione nel caso in cui sia necessaria la ridondanza nel percorso di peering specificato.

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

Il cmdlet di PowerShell New-AzPeering può essere usato per creare un nuovo peering di Exchange.

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

 

Questa risposta di esempio mostra quando la richiesta è stata eseguita usando una connessione.


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

Importante

Microsoft avvia il provisioning del peering richiesto e ConnectionState riflette lo stato di avanzamento. Per altre informazioni sui passaggi correlati al provisioning, vedere la procedura dettagliata sul peering di Exchange.

È possibile controllare lo stato della connessione, come illustrato di seguito.


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

Ottenere il peering di Exchange

Per ottenere l'elenco dei peering, eseguire il comando Get-AzPeering .

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

Questa risposta di esempio mostra quando il provisioning end-to-end è stato completato correttamente.

    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

Modificare un peering di Exchange

Per il peering di Exchange sono supportate le operazioni di modifica seguenti:

  • Aggiungere connessioni peering di Exchange.
  • Rimuovere le connessioni peering di Exchange.
  • Aggiungere una sessione IPv4 o IPv6 nelle connessioni attive.
  • Rimuovere una sessione IPv4 o IPv6 nelle connessioni attive.

Aggiungere connessioni peering di Exchange

In questo esempio viene descritto come aggiungere connessioni a un peering di Exchange esistente.


$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

Rimuovere le connessioni peering di Exchange

In questo esempio viene descritto come rimuovere le connessioni a un peering di Exchange esistente.


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

Visualizzare tutte le connessioni e selezionare la connessione da rimuovere.


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

Nel comando seguente, anziché 0, immettere il numero di indice per la connessione da rimuovere.


$connection = $exchangePeering.Connections[0]

$exchangePeering.Connections.Remove($connection)

$exchangePeering | Update-AzPeering

Aggiungere una sessione IPv4 o IPv6 nelle connessioni attive

Questo esempio descrive come aggiungere una sessione IPv6 a una connessione exchange esistente.


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

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

$exchangePeering | Update-AzPeering

Rimuovere una sessione IPv4 o IPv6 nelle connessioni attive

La rimozione di una sessione IPv4 o IPv6 da una connessione esistente non è attualmente supportata in PowerShell. Per altre informazioni, contattare il peering Microsoft.

Effettuare il deprovisioning di un peering di Exchange

Attualmente, il deprovisioning non è supportato usando il portale di Azure o PowerShell. Per eseguire il deprovisioning, contattare il peering Microsoft.

Risorse aggiuntive

È possibile ottenere descrizioni dettagliate di tutti i parametri eseguendo il comando seguente:

Get-Help Get-AzPeering -detailed

Passaggi successivi