Vytvoření nebo úprava partnerského vztahu Exchange pomocí PowerShellu
Tento článek popisuje, jak vytvořit partnerský vztah Microsoft Exchange pomocí rutin Prostředí PowerShell a modelu nasazení Resource Manager. Tento článek také ukazuje, jak zkontrolovat stav prostředku, aktualizovat ho nebo odstranit a zrušit jeho zřízení.
Pokud chcete, můžete tuto příručku dokončit pomocí webu Azure Portal.
Než začnete
- Než začnete s konfigurací, projděte si požadavky a názorný postup partnerského vztahu Exchange.
- Pokud už máte partnerské vztahy Exchange s Microsoftem, které nejsou převedené na prostředky Azure, přečtěte si téma Převod starší verze partnerského vztahu Exchange na prostředek Azure pomocí PowerShellu.
Práce s Azure PowerShellem
Ke spuštění rutin můžete použít Azure Cloud Shell, bezplatné interaktivní prostředí. Má předinstalované obecné nástroje Azure, které jsou nakonfigurované pro použití s vaším účtem. Vyberte Kopírovat a zkopírujte kód a vložte ho do Cloud Shellu. Potom ho spusťte výběrem klávesy Enter . Cloud Shell můžete spustit několika způsoby:
| Launch – metoda | Snímek obrazovky |
|---|---|
| Otevřete Cloud Shell ve vašem prohlížeči. |  |
| Na panelu nástrojů v pravém horním rohu webu Azure Portal vyberte tlačítko Cloud Shell. |  |
Pokud nechcete používat Azure Cloud Shell, můžete powershell nainstalovat místně. Pokud se rozhodnete nainstalovat a používat PowerShell místně, nezapomeňte nainstalovat nejnovější verzi rutin PowerShellu Azure Resource Manageru. Rutiny PowerShellu se často aktualizují. Obvykle potřebujete aktualizovat rutiny PowerShellu, abyste získali nejnovější funkce funkcí. Pokud ne, může docházet k problémům.
Pokud chcete najít verzi PowerShellu, kterou používáte místně, použijte rutinu Get-Module -ListAvailable Az . Informace o aktualizaci najdete v tématu Instalace modulu Azure PowerShell. Další informace najdete v tématu instalace a konfigurace Azure PowerShellu.
Pokud používáte PowerShell v systému macOS, postupujte podle pokynů v instalaci PowerShellu v systému macOS.
Vytvoření a zřízení partnerského vztahu Exchange
Přihlaste se ke svému účtu Azure a vyberte své předplatné.
Než začnete s konfigurací, nainstalujte a naimportujte požadované moduly. K instalaci modulů v PowerShellu potřebujete oprávnění správce.
Nainstalujte a naimportujte modul Az.
Install-Module Az -AllowClobber Import-Module AzNainstalujte a naimportujte modul Az.Peering.
Install-Module -Name Az.Peering -AllowClobber Import-Module Az.PeeringPomocí tohoto příkazu ověřte, že se moduly naimportují správně:
Get-ModulePřihlaste se ke svému účtu Azure pomocí tohoto příkazu:
Connect-AzAccountZkontrolujte předplatná pro účet a vyberte předplatné, ve kterém chcete vytvořit partnerský vztah.
Get-AzSubscription Select-AzSubscription -SubscriptionId "subscription-id"Pokud ještě nemáte skupinu prostředků, musíte ji vytvořit před vytvořením partnerského vztahu. Můžete to provést spuštěním následujícího příkazu:
New-AzResourceGroup -Name "PeeringResourceGroup" -Location "Central US"
Důležité
Pokud jste ještě nepřidružili asn a předplatné, postupujte podle kroků v části Přidružení partnerského asn. Tato akce se vyžaduje k vyžádání partnerského vztahu.
Poznámka:
Umístění skupiny prostředků je nezávislé na umístění, ve kterém se rozhodnete nastavit partnerský vztah.
Získání seznamu podporovaných umístění partnerského vztahu pro partnerský vztah Exchange
Rutina PowerShellu Get-AzPeeringLocation vrátí seznam umístění partnerského vztahu s povinným parametrem Kind, který použijete v dalších krocích.
Get-AzPeeringLocation -Kind "Exchange"
Umístění partnerského vztahu Exchange obsahují následující pole:
- ExchangeName
- PeeringLocation
- Země
- PeeringDBFacilityId
- PeeringDBFacilityLink
- MicrosoftIPv4Address
- MicrosoftIPv6Address
Pomocí odkazu na PeeringDB ověřte, že se nacházíte v požadovaném partnerském prostředí.
Tento příklad ukazuje, jak použít Seattle jako umístění partnerského vztahu k vytvoření partnerského vztahu.
$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
...
Vytvoření partnerského vztahu Exchange
Následující příklad ukazuje, jak vytvořit připojení Exchange na Equinix Internet Exchange v Seattlu. Pokud používáte jiného poskytovatele a různá nastavení, při vytváření žádosti nahraďte informace.
Pomocí rutiny PowerShellu New-AzPeeringExchangeConnectionObject vytvořte objekty připojení PowerShellu, které se použijí k vygenerování nové žádosti o partnerský vztah.
Tento příklad ukazuje, jak vytvořit připojení k Exchangi.
$connection1 = New-AzPeeringExchangeConnectionObject `
-PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
-PeerSessionIPv4Address 198.32.134.22 `
-PeerSessionIPv6Address 2001:504:12::22 `
-MaxPrefixesAdvertisedIPv4 2000 `
-MaxPrefixesAdvertisedIPv6 2000 `
Pokud potřebujete redundanci v daném umístění partnerského vztahu, vytvořte další připojení.
$connection2 = New-AzPeeringExchangeConnectionObject `
-PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
-PeerSessionIPv4Address 198.32.134.23 `
-PeerSessionIPv6Address 2001:504:12::23 `
-MaxPrefixesAdvertisedIPv4 2000 `
-MaxPrefixesAdvertisedIPv6 2000 `
Rutina PowerShellu New-AzPeering se dá použít k vytvoření nového partnerského vztahu Exchange.
$asn = Get-AzPeerAsn
New-AzPeering `
-Name "SeattleExchangePeering" `
-ResourceGroupName "PeeringResourceGroup" `
-PeerAsnResourceId $asn.Id `
-PeeringLocation $exchangeLocation[1].PeeringLocation `
-ExchangeConnection $connection1[, $connection2]
Tato ukázková odpověď ukazuje, kdy se požadavek spustil pomocí jednoho připojení.
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 : {}
Důležité
Microsoft začne zřizovat požadovaný partnerský vztah a ConnectionState odráží průběh.
Další informace o krocích souvisejících se zřizováním najdete v průvodci partnerským vztahem Exchange.
Stav připojení můžete zkontrolovat, jak je znázorněno tady.
$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 :
Získání partnerského vztahu Exchange
Pokud chcete získat seznam partnerských vztahů, spusťte příkaz Get-AzPeering .
Get-AzPeering ResourceGroupName "PeeringResourceGroup" -Name "SeattleExchangePeering"
Tato ukázková odpověď ukazuje, kdy se kompletní zřizování úspěšně dokončilo.
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
Úprava partnerského vztahu Exchange
Pro partnerský vztah Exchange se podporují následující operace úprav:
- Přidejte připojení peeringu Exchange.
- Odeberte připojení peeringu Exchange.
- Přidejte relaci IPv4 nebo IPv6 pro aktivní připojení.
- Odeberte relaci IPv4 nebo IPv6 u aktivních připojení.
Přidání připojení peeringu Exchange
Tento příklad popisuje, jak přidat připojení k existujícímu partnerskému vztahu 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
Odebrání připojení peeringu Exchange
Tento příklad popisuje, jak odebrat připojení k existujícímu partnerskému vztahu Exchange.
$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
Zobrazte všechna připojení a vyberte připojení, které chcete odebrat.
$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 : {}
V následujícím příkazu místo 0 zadejte číslo indexu pro připojení, které chcete odebrat.
$connection = $exchangePeering.Connections[0]
$exchangePeering.Connections.Remove($connection)
$exchangePeering | Update-AzPeering
Přidání relace IPv4 nebo IPv6 u aktivních připojení
Tento příklad popisuje, jak přidat relaci IPv6 do existujícího připojení Exchange.
$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
$exchangePeering.Connections[0].BgpSession.PeerSessionIPv6Address = "2001:504:12::34"
$exchangePeering | Update-AzPeering
Odebrání relace IPv4 nebo IPv6 u aktivních připojení
Odebrání relace IPv4 nebo IPv6 z existujícího připojení se v současné době nepodporuje v PowerShellu. Další informace získáte od partnerského vztahu Microsoftu.
Zrušení zřízení partnerského vztahu Exchange
V současné době se zrušení zřízení nepodporuje pomocí webu Azure Portal ani PowerShellu. Pokud chcete zrušit zřízení, obraťte se na partnerský vztah Microsoftu.
Další materiály
Podrobný popis všech parametrů můžete získat spuštěním následujícího příkazu:
Get-Help Get-AzPeering -detailed