Vytvoření nebo úprava přímého partnerského vztahu pomocí PowerShellu
Tento článek popisuje, jak vytvořit partnerský vztah Microsoft Direct pomocí rutin PowerShellu a modelu nasazení Azure 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 přímého partnerského vztahu.
- Pokud už máte přímá připojení peeringu s Microsoftem, která nejsou převedená na prostředky Azure, přečtěte si téma Převod starší verze partnerského vztahu Direct 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í přímého partnerského vztahu
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í peeringu pro přímý partnerský vztah
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 Direct
Umístění přímého partnerského vztahu obsahují následující pole:
- PeeringLocation
- Země
- PeeringDBFacilityId
- PeeringDBFacilityLink
- BandwidthOffers
Ověřte, že jste přítomni v požadovaném partnerském prostředí, a to pomocí odkazu na PeeringDB.
Tento příklad ukazuje, jak použít Seattle jako umístění partnerského vztahu k vytvoření přímého partnerského vztahu.
$peeringLocations = Get-AzPeeringLocation -Kind Direct
$peeringLocation = $peeringLocations | where {$_.PeeringLocation -contains "Seattle"}
$peeringLocation
PeeringLocation : Seattle
Address : 2001 Sixth Avenue
Country : US
PeeringDBFacilityId : 71
PeeringDBFacilityLink : https://www.peeringdb.com/fac/71
BandwidthOffers : {10Gbps, 100Gbps}
Vytvoření přímého partnerského vztahu
Následující příklad ukazuje, jak vytvořit partnerský vztah 10 Gb/s Direct v Seattlu.
Pomocí rutiny PowerShellu New-AzPeeringDirectConnectionObject vytvořte objekty DirectConnection, které se mají použít v novém požadavku peeringu.
Tento příklad ukazuje, jak vytvořit DirectConnection objekt.
$connection1 = New-AzPeeringDirectConnectionObject `
-PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
-SessionPrefixV4 10.21.31.0/31 `
-SessionPrefixV6 fe01::3e:0/127 `
-MaxPrefixesAdvertisedIPv4 1000 `
-MaxPrefixesAdvertisedIPv6 100 `
-BandwidthInMbps 10000
Poznámka:
Hodnota pro $peeringLocation[] v předchozím příkladu by měla odpovídat umístění partnerského vztahu podle vašeho výběru.
Pokud potřebujete redundanci v daném umístění partnerského vztahu, vytvořte další připojení.
$connection2 = New-AzPeeringDirectConnectionObject `
-PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
-SessionPrefixV4 10.21.33.0/31 `
-SessionPrefixV6 fe01::3f:0/127 `
-MaxPrefixesAdvertisedIPv4 1000 `
-MaxPrefixesAdvertisedIPv6 100 `
-BandwidthInMbps 10000
Pomocí rutiny PowerShellu New-AzPeering vytvořte nový partnerský vztah Direct. Tento příkaz vyžaduje ID prostředku ASN, které je možné načíst, jak je znázorněno zde.
$asn = Get-AzPeerAsn
New-AzPeering `
-Name "SeattleDirectPeering" `
-ResourceGroupName "PeeringResourceGroup" `
-PeeringLocation $peeringLocation[0].PeeringLocation `
-PeerAsnResourceId $asn.Id `
-DirectConnection $connection1 [, $connection2]
Tento příklad ukazuje odpověď, když se požadavek úspěšně zpracoval.
Name : SeattleDirectPeering
Sku.Name : Basic_Direct_Free
Kind : Direct
Connections : 71
PeerAsn.Id : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/SeattleDirectPeering
UseForPeeringService : False
PeeringLocation : Seattle
ProvisioningState : Succeeded
Location : centralus
Id : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
Type : Microsoft.Peering/peerings
Tags : {}
Všimněte si, že místo {subscriptionId} v tomto výstupu se zobrazí skutečné ID předplatného.
Ověření přímého partnerského vztahu
Pokud chcete získat seznam partnerských vztahů, spusťte příkaz Get-AzPeering .
$directPeering = Get-AzPeering -ResourceGroupName "PeeringResourceGroup" -Name "SeattleDirectPeering"
Následující příklad ukazuje odpověď, když bylo dokončeno kompletní zřizování.
Name : SeattleDirectPeering
Sku.Name : Basic_Direct_Free
Kind : Direct
Connections : {71}
PeerAsn.Id : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/SeattleDirectPeering
UseForPeeringService : False
PeeringLocation : Seattle
ProvisioningState : Succeeded
Location : centralus
Id : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
Type : Microsoft.Peering/peerings
Tags : {}
Úprava přímého partnerského vztahu
Tato část popisuje, jak provádět následující operace úprav pro přímý partnerský vztah:
- Přidání přímých připojení peeringu
- Odeberte přímá připojení peeringu.
- Upgradujte nebo downgradujte šířku pásma u aktivních připojení.
- Přidejte relace IPv4 nebo IPv6 pro aktivní připojení.
- Odeberte relace IPv4 nebo IPv6 u aktivních připojení.
Přidání přímých připojení peeringu
Tento příklad popisuje, jak přidat připojení k existujícímu partnerskému vztahu Direct.
$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$connection = New-AzPeeringDirectConnection `
-PeeringDBFacilityId $peeringLocation.PeeringDBFacilityId `
-SessionPrefixV4 "10.22.31.0/31" `
-SessionPrefixV6 "fe02::3e:0/127" `
-MaxPrefixesAdvertisedIPv4 1000 `
-MaxPrefixesAdvertisedIPv6 100 `
-BandwidthInMbps 10000
$directPeering.Connections.Add($connection)
$directPeering | Update-AzPeering
Odebrání přímých připojení peeringu
Odebrání připojení se v současné době nepodporuje v PowerShellu. Další informace získáte od partnerského vztahu Microsoftu.
Upgrade nebo downgrade šířky pásma u aktivních připojení
Tento příklad popisuje, jak přidat 10 Gb/s do existujícího přímého připojení.
$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BandwidthInMbps = 20000
$directPeering | Update-AzPeering
Přidání relací IPv4 nebo IPv6 u aktivních připojení
Tento příklad popisuje, jak přidat relaci IPv6 u existujícího přímého připojení pouze s relací IPv4.
$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BGPSession.SessionPrefixv6 = "fe01::3e:0/127"
$directPeering | Update-AzPeering
Odebrání relací 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í přímého partnerského vztahu
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