使用 PowerShell 建立和修改 ExpressRoute 線路的對等互連
本文可協助您使用 PowerShell,在 Resource Manager 部署模型中建立和管理 ExpressRoute 線路的路由設定。 您還可以檢查狀態、更新,或是刪除與取消佈建 ExpressRoute 線路的對等互連。 如果您想要對線路使用不同的方法,可選取下列清單中的文章:
這些指示只適用於由提供第 2 層連線服務的服務提供者所建立的線路。 如果您使用提供受控第 3 層服務的服務提供者,通常是 IPVPN,例如 MPLS,您的連線提供者會為您設定和管理網路路由。
重要
我們目前不會透過服務管理入口網站來公告服務提供者所設定的對等。 我們正努力在近期推出這項功能。 設定 BGP 對等互連之前,請洽詢您的服務提供者。
您可以為 ExpressRoute 線路設定私人對等互連和 Microsoft 對等互連 (針對新線路的 Azure 公用對等互連已被取代)。 您可以依自己選擇的任何順序設定對等互連。 不過,您必須確定您逐一完成各個對等互連的設定。 如需路由網域和對等互連的詳細資訊,請參閱 ExpressRoute 路由網域。 如需公用對等互連的詳細資訊,請參閱 ExpressRoute 公用對等互連。
在本教學課程中,您會了解如何:
- 設定、更新和刪除線路的 Microsoft 對等互連
- 設定、更新和刪除線路的 Azure 私人對等互連
必要條件
- 開始設定之前,請確定您已檢閱下列頁面:
- 您必須具有作用中的 ExpressRoute 線路。 繼續之前,請遵循指示來建立 ExpressRoute 線路,並由您的連線提供者來啟用該線路。 ExpressRoute 線路必須處於布建且已啟用的狀態,才能執行本文中的 Cmdlet。
Azure Cloud Shell
Azure Cloud Shell 是裝載於 Azure 中的互動式殼層環境,可在瀏覽器中使用。 您可以使用 Bash 或 PowerShell 搭配 Cloud Shell,與 Azure 服務共同使用。 您可以使用 Cloud Shell 預先安裝的命令,執行本文提到的程式碼,而不必在本機環境上安裝任何工具。
要啟動 Azure Cloud Shell:
選項 | 範例/連結 |
---|---|
選取程式碼或命令區塊右上角的 [試試看]。 選取 [試試看] 並不會自動將程式碼或命令複製到 Cloud Shell 中。 | |
請前往 https://shell.azure.com,或選取 [啟動 Cloud Shell] 按鈕,在瀏覽器中開啟 Cloud Shell。 | |
選取 Azure 入口網站右上方功能表列上的 [Cloud Shell] 按鈕。 |
若要使用 Azure Cloud Shell:
啟動 Cloud Shell。
選取程式碼區塊 (或命令區塊) 上的 [複製] 按鈕以複製程式碼或命令。
透過在 Windows 和 Linux 上選取 Ctrl+Shift+V;或在 macOS 上選取 Cmd+Shift+V,將程式碼或命令貼到 Cloud Shell 工作階段中。
選取 Enter 鍵執行程式碼或命令。
Microsoft 對等互連
本節將協助您為 ExpressRoute 線路建立、取得、更新和刪除 Microsoft 對等互連設定。
重要
在 2017 年 8 月 1 日以前設定之 ExpressRoute 線路的 Microsoft 對等互連,會透過 Microsoft 對等互連公告所有服務首碼,即使未定義路由篩選也一樣。 在 2017 年 8 月 1 日當日或之後設定之 ExpressRoute 線路的 Microsoft 對等互連,不會公告任何前置詞,直到路由篩選連結至線路為止。 如需詳細資訊,請參閱設定 Microsoft 對等互連的路由篩選。
建立 Microsoft 對等
登入並選取您的訂用帳戶。
如果您在本機安裝PowerShell,請登入。 如果您使用 Azure Cloud Shell,您可以略過此步驟。
Connect-AzAccount
選取您要建立 ExpressRoute 線路的訂用帳戶。
Select-AzSubscription -SubscriptionId "<subscription ID>"
建立 ExpressRoute 線路。
請遵循指示建立 ExpressRoute 線路 ,並由連線提供者佈建它。 若您的連線提供者提供受控第 3 層服務,您可以要求連線提供者為您啟用 Microsoft 對等互連。 您不需要遵循下一節所列的指示。 不過,如果您的連線提供者不管理路由,請在建立線路之後繼續使用後續步驟進行設定。
檢查 ExpressRoute 線路,以確定已佈建且已啟用線路。 請使用下列範例:
Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"
回應如下列範例所示:
Name : ExpressRouteARMCircuit ResourceGroupName : ExpressRouteResourceGroup Location : westus Id : /subscriptions/***************************/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit Etag : W/"################################" ProvisioningState : Succeeded Sku : { "Name": "Standard_MeteredData", "Tier": "Standard", "Family": "MeteredData" } CircuitProvisioningState : Enabled ServiceProviderProvisioningState : Provisioned ServiceProviderNotes : ServiceProviderProperties : { "ServiceProviderName": "Equinix", "PeeringLocation": "Silicon Valley", "BandwidthInMbps": 200 } ServiceKey : ************************************** Peerings : []
設定線路的 Microsoft 對等。 繼續之前,請確定您擁有下列資訊。
- 主要連結的 /30 或 /126 子網。 位址區塊必須是您擁有的有效公用 IPv4 或 IPv6 前置詞,且已在 RIR / IRR 中註冊。
- 次要連結的 /30 或 /126 子網。 位址區塊必須是您擁有的有效公用 IPv4 或 IPv6 前置詞,且已在 RIR / IRR 中註冊。
- 供建立此對等的有效 VLAN ID。 請確定線路有沒有其他對等使用相同的 VLAN ID。
- 對等的 AS 編號。 您可以使用 2 位元組和 4 位元組 AS 編號。
- 公告的首碼:您要提供一份您打算透過 BGP 工作階段公告的所有前置詞清單。 只接受公用 IP 位址首碼。 如果計劃傳送一組前置詞,可以傳送以逗號分隔的清單。 這些前置詞必須在 RIR / IRR 中註冊給您。 IPv4 BGP 工作階段需要 IPv4 已公告首碼,而 IPv6 BGP 工作階段需要 IPv6 已公告首碼。
- 路由登錄名稱:您可以指定可供註冊 AS 編號和首碼的 RIR / IRR。
- 選:
- 客戶 ASN:如果您要公告未向對等互連 AS 編號註冊的前置詞,您可以指定其註冊的 AS 編號。
- MD5 雜湊 (如果選擇使用)。
重要
Microsoft 會驗證指定的「已公告公用首碼」和「對等互連 ASN」(或「客戶 ASN」) 是否已在網際網路路由登錄中指派給您。 如果您要從另一個實體取得公用首碼,以及如果未使用路由登錄來記錄指派,則自動驗證將不會完成,而且需要手動驗證。 如果自動驗證失敗,您會在 「Get-AzExpressRouteCircuitPeeringConfig」 的輸出中看到 『AdvertisedPublicPrefixesState』(請參閱下一節中的<取得 Microsoft 對等互連詳細數據>)。
如果您看到「需要驗證」訊息,請收集其中顯示實體已將公用前置詞指派給您組織的文件,而此實體列示為路由登錄中的前置詞擁有者,然後開啟支援票證,提交這些文件進行手動驗證。
使用下列範例來設定線路的 Microsoft 對等互連:
Add-AzExpressRouteCircuitPeeringConfig -Name "MicrosoftPeering" -ExpressRouteCircuit $ckt -PeeringType MicrosoftPeering -PeerASN 100 -PeerAddressType IPv4 -PrimaryPeerAddressPrefix "123.0.0.0/30" -SecondaryPeerAddressPrefix "123.0.0.4/30" -VlanId 300 -MicrosoftConfigAdvertisedPublicPrefixes "123.1.0.0/24" -MicrosoftConfigCustomerAsn 23 -MicrosoftConfigRoutingRegistryName "ARIN"
Add-AzExpressRouteCircuitPeeringConfig -Name "MicrosoftPeering" -ExpressRouteCircuit $ckt -PeeringType MicrosoftPeering -PeerASN 100 -PeerAddressType IPv6 -PrimaryPeerAddressPrefix "3FFE:FFFF:0:CD30::/126" -SecondaryPeerAddressPrefix "3FFE:FFFF:0:CD30::4/126" -VlanId 300 -MicrosoftConfigAdvertisedPublicPrefixes "3FFE:FFFF:0:CD31::/120" -MicrosoftConfigCustomerAsn 23 -MicrosoftConfigRoutingRegistryName "ARIN"
Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
取得 Microsoft 對等互連詳細數據
您可以使用下列範例取得組態詳細資料:
$ckt = Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"
Get-AzExpressRouteCircuitPeeringConfig -Name "MicrosoftPeering" -ExpressRouteCircuit $ckt
更新 Microsoft 對等組態
您可以使用下列範例來更新組態的任何部份:
Set-AzExpressRouteCircuitPeeringConfig -Name "MicrosoftPeering" -ExpressRouteCircuit $ckt -PeeringType MicrosoftPeering -PeerASN 100 -PeerAddressType IPv4 -PrimaryPeerAddressPrefix "123.0.0.0/30" -SecondaryPeerAddressPrefix "123.0.0.4/30" -VlanId 300 -MicrosoftConfigAdvertisedPublicPrefixes "124.1.0.0/24" -MicrosoftConfigCustomerAsn 23 -MicrosoftConfigRoutingRegistryName "ARIN"
Set-AzExpressRouteCircuitPeeringConfig -Name "MicrosoftPeering" -ExpressRouteCircuit $ckt -PeeringType MicrosoftPeering -PeerASN 100 -PeerAddressType IPv6 -PrimaryPeerAddressPrefix "3FFE:FFFF:0:CD30::/126" -SecondaryPeerAddressPrefix "3FFE:FFFF:0:CD30::4/126" -VlanId 300 -MicrosoftConfigAdvertisedPublicPrefixes "3FFE:FFFF:0:CD31::/120" -MicrosoftConfigCustomerAsn 23 -MicrosoftConfigRoutingRegistryName "ARIN"
Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
Azure 私用對等互連
本節將協助您為 ExpressRoute 線路建立、取得、更新和刪除 Azure 私用對等互連設定。
建立 Azure 私用對等
匯入 ExpressRoute 的 PowerShell 模組。
從 PowerShell 資源庫 安裝最新的 PowerShell 安裝程式。 然後將 Azure Resource Manager 模組匯入 PowerShell 會話,以開始使用 ExpressRoute Cmdlet。 您必須以 管理員 istrator 身分執行 PowerShell。
Install-Module Az
在已知的語意版本範圍內匯入所有 Az.* 模組。
Import-Module Az
您也可以直接在已知的語意版本範圍內匯入選取模組。
Import-Module Az.Network
登入您的帳戶。
Connect-AzAccount
選取您要建立 ExpressRoute 線路的訂用帳戶。
Select-AzSubscription -SubscriptionId "<subscription ID>"
建立 ExpressRoute 線路。
請遵循指示建立 ExpressRoute 線路 ,並由連線提供者佈建它。 若您的連線提供者是提供受控第 3 層服務,您可以要求連線提供者為您啟用 Azure 私人對等互連。 您不需要遵循下一節所列的指示。 不過,如果您的連線提供者不管理路由,請在建立線路之後繼續使用後續步驟進行設定。
檢查 ExpressRoute 線路,以確定已佈建且已啟用線路。 請使用下列範例:
Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"
回應如下列範例所示:
Name : ExpressRouteARMCircuit ResourceGroupName : ExpressRouteResourceGroup Location : westus Id : /subscriptions/***************************/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit Etag : W/"################################" ProvisioningState : Succeeded Sku : { "Name": "Standard_MeteredData", "Tier": "Standard", "Family": "MeteredData" } CircuitProvisioningState : Enabled ServiceProviderProvisioningState : Provisioned ServiceProviderNotes : ServiceProviderProperties : { "ServiceProviderName": "Equinix", "PeeringLocation": "Silicon Valley", "BandwidthInMbps": 200 } ServiceKey : ************************************** Peerings : []
設定線路的 Azure 私用對等。 繼續執行接下來的步驟之前,請確定您有下列項目:
- 一對子網路,不屬於保留給虛擬網路的任何位址空間。 一個子網用於主要連結,另一個子網則用於次要連結。 從每個子網中,您會將第一個可用 IP 位址指派給路由器,因為 Microsoft 會將第二個可用 IP 用於其路由器。 這對子網路有三個選項可供使用:
- IPv4:兩個 /30 子網路。
- IPv6:兩個 /126 子網路。
- 兩者:兩個 /30 子網路和兩個 /126 子網路。
- 供建立此對等的有效 VLAN ID。 請確定線路有沒有其他對等使用相同的 VLAN ID。
- 對等的 AS 編號。 您可以使用 2 位元組和 4 位元組 AS 編號。 您可以將私用 AS 編號用於此對等。 確保您不是使用 65515。
- 選:
- MD5 雜湊 (如果選擇使用)。
使用下列範例來為線路設定 Azure 私用對等互連:
Add-AzExpressRouteCircuitPeeringConfig -Name "AzurePrivatePeering" -ExpressRouteCircuit $ckt -PeeringType AzurePrivatePeering -PeerASN 100 -PrimaryPeerAddressPrefix "10.0.0.0/30" -SecondaryPeerAddressPrefix "10.0.0.4/30" -VlanId 200 Add-AzExpressRouteCircuitPeeringConfig -Name "AzurePrivatePeering" -ExpressRouteCircuit $ckt -PeeringType AzurePrivatePeering -PeerASN 100 -PrimaryPeerAddressPrefix "3FFE:FFFF:0:CD30::/126" -SecondaryPeerAddressPrefix "3FFE:FFFF:0:CD30::4/126" -VlanId 200 -PeerAddressType IPv6 Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
如果您選擇使用 MD5 雜湊,請使用下列範例:
Add-AzExpressRouteCircuitPeeringConfig -Name "AzurePrivatePeering" -ExpressRouteCircuit $ckt -PeeringType AzurePrivatePeering -PeerASN 100 -PrimaryPeerAddressPrefix "10.0.0.0/30" -SecondaryPeerAddressPrefix "10.0.0.4/30" -VlanId 200 -SharedKey "A1B2C3D4" Add-AzExpressRouteCircuitPeeringConfig -Name "AzurePrivatePeering" -ExpressRouteCircuit $ckt -PeeringType AzurePrivatePeering -PeerASN 100 -PrimaryPeerAddressPrefix "3FFE:FFFF:0:CD30::/126" -SecondaryPeerAddressPrefix "3FFE:FFFF:0:CD30::4/126" -VlanId 200 -PeerAddressType IPv6 -SharedKey "A1B2C3D4"
重要
請確定您將 AS 編號指定為對等 ASN,而不是客戶 ASN。
- 一對子網路,不屬於保留給虛擬網路的任何位址空間。 一個子網用於主要連結,另一個子網則用於次要連結。 從每個子網中,您會將第一個可用 IP 位址指派給路由器,因為 Microsoft 會將第二個可用 IP 用於其路由器。 這對子網路有三個選項可供使用:
若要取得 Azure 私人對等互連詳細數據
您可以使用下列範例來取得設定詳細資料:
$ckt = Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"
Get-AzExpressRouteCircuitPeeringConfig -Name "AzurePrivatePeering" -ExpressRouteCircuit $ckt
更新 Azure 私用對等組態
您可以使用下列範例來更新設定的任何部分。 在此範例中,線路的 VLAN 標識符會從 200 更新為 500。
Set-AzExpressRouteCircuitPeeringConfig -Name "AzurePrivatePeering" -ExpressRouteCircuit $ckt -PeeringType AzurePrivatePeering -PeerASN 100 -PrimaryPeerAddressPrefix "10.0.0.0/30" -SecondaryPeerAddressPrefix "10.0.0.4/30" -VlanId 500
Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
清除資源
刪除 Microsoft 對等
您可以執行下列 Cmdlet 來移除對等組態:
Remove-AzExpressRouteCircuitPeeringConfig -Name "MicrosoftPeering" -ExpressRouteCircuit $ckt
Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
刪除 Azure 私用對等
您可以執行下列範例來移除對等互連設定:
警告
執行此範例之前,您必須確定已移除所有虛擬網路與 ExpressRoute Global Reach 連線。
Remove-AzExpressRouteCircuitPeeringConfig -Name "AzurePrivatePeering" -ExpressRouteCircuit $ckt
Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
下一步
設定 Azure 私人對等互連之後,您可以建立 ExpressRoute 閘道,以將虛擬網路連結至線路。