New-AzureRmExpressRouteCircuitPeeringConfig
建立要新增至 ExpressRoute 線路的新對等互連組態。
警告
自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。
語法
New-AzureRmExpressRouteCircuitPeeringConfig
-Name <String>
-PeeringType <String>
-PeerASN <UInt32>
-PrimaryPeerAddressPrefix <String>
-SecondaryPeerAddressPrefix <String>
-VlanId <Int32>
[-SharedKey <String>]
[-MicrosoftConfigAdvertisedPublicPrefixes <System.Collections.Generic.List`1[System.String]>]
[-MicrosoftConfigCustomerAsn <Int32>]
[-MicrosoftConfigRoutingRegistryName <String>]
[-PeerAddressType <String>]
[-LegacyMode <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRmExpressRouteCircuitPeeringConfig
-Name <String>
-PeeringType <String>
-PeerASN <UInt32>
-PrimaryPeerAddressPrefix <String>
-SecondaryPeerAddressPrefix <String>
-VlanId <Int32>
[-SharedKey <String>]
[-MicrosoftConfigAdvertisedPublicPrefixes <System.Collections.Generic.List`1[System.String]>]
[-MicrosoftConfigCustomerAsn <Int32>]
[-MicrosoftConfigRoutingRegistryName <String>]
-RouteFilterId <String>
[-PeerAddressType <String>]
[-LegacyMode <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRmExpressRouteCircuitPeeringConfig
-Name <String>
-PeeringType <String>
-PeerASN <UInt32>
-PrimaryPeerAddressPrefix <String>
-SecondaryPeerAddressPrefix <String>
-VlanId <Int32>
[-SharedKey <String>]
[-MicrosoftConfigAdvertisedPublicPrefixes <System.Collections.Generic.List`1[System.String]>]
[-MicrosoftConfigCustomerAsn <Int32>]
[-MicrosoftConfigRoutingRegistryName <String>]
-RouteFilter <PSRouteFilter>
[-PeerAddressType <String>]
[-LegacyMode <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
New-AzureRmExpressRouteCircuitPeeringConfig Cmdlet 會將對等互連設定新增至 ExpressRoute 線路。 ExpressRoute 線路會使用連線提供者，而不是公用因特網，將內部部署網路連線到Microsoft雲端。
範例
範例 1：使用對等互連設定建立新的 ExpressRoute 線路
$parameters = @{
Name = 'AzurePrivatePeering'
Circuit = $circuit
PeeringType = 'AzurePrivatePeering'
PeerASN = 100
PrimaryPeerAddressPrefix = '10.6.1.0/30'
SecondaryPeerAddressPrefix = '10.6.2.0/30'
VlanId = 200
}
$PeerConfig = New-AzureRmExpressRouteCircuitPeeringConfig @parameters
$parameters = @{
Name='ExpressRouteCircuit'
ResourceGroupName='ExpressRouteResourceGroup'
Location='West US'
SkuTier='Standard'
SkuFamily='MeteredData'
ServiceProviderName='Equinix'
Peering=$PeerConfig
PeeringLocation='Silicon Valley'
BandwidthInMbps=200
}
New-AzureRmExpressRouteCircuit @parameters參數
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-LegacyMode
對等互連的舊版模式
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-MicrosoftConfigAdvertisedPublicPrefixes
針對 MicrosoftPeering 的 PeeringType，您必須提供您計畫透過 BGP 會話公告的所有前置詞清單。 只接受公用 IP 位址前置詞。 如果您打算傳送一組前置詞，則可以傳送逗號分隔清單。 這些前置詞必須在路由登錄名稱 （RIR / IRR） 中向您註冊。
| 類型: | List<T>[String] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-MicrosoftConfigCustomerAsn
如果您是未向對等互連 AS 編號註冊的廣告前置詞，您可以指定其註冊的 AS 編號。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-MicrosoftConfigRoutingRegistryName
註冊 AS 編號和前置詞的路由登錄名稱 （RIR / IRR）。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
要建立的對等互連組態名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PeerAddressType
PeerAddressType
| 類型: | String |
| 接受的值: | IPv4, IPv6 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PeerASN
ExpressRoute 線路的 AS 編號。 當 PeeringType 是 AzurePublicPeering 時，這必須是公用 ASN。
| 類型: | UInt32 |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PeeringType
此參數可接受的值為： AzurePrivatePeering、 AzurePublicPeering、 和 MicrosoftPeering
| 類型: | String |
| 接受的值: | AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PrimaryPeerAddressPrefix
這是這個對等互連關聯性之主要路由路徑的IP位址範圍。 這必須是 /30 CIDR 子網。 此子網中的第一個奇數位址應指派給您的路由器介面。 Azure 會設定 Azure 路由器介面的下一個偶數位址。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RouteFilter
這是現有的 RouteFilter 物件。
| 類型: | PSRouteFilter |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-RouteFilterId
這是現有 RouteFilter 對象的資源識別碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-SecondaryPeerAddressPrefix
這是這個對等互連關聯性之次要路由路徑的IP位址範圍。 這必須是 /30 CIDR 子網。 此子網中的第一個奇數位址應指派給您的路由器介面。 Azure 會設定 Azure 路由器介面的下一個偶數位址。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SharedKey
這是選擇性的 MD5 哈希，用來作為對等互連設定的預先共用密鑰。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-VlanId
這是為此對等互連指派的 VLAN 識別碼。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |