共用方式為

Set-AzExpressRouteCircuitPeeringConfig

  • 參考
模組:
Az.Network

儲存修改過的 ExpressRoute 對等互連組態。

語法

Set-AzExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -PeeringType <String>
   -PeerASN <UInt32>
   -PrimaryPeerAddressPrefix <String>
   -SecondaryPeerAddressPrefix <String>
   -VlanId <Int32>
   [-SharedKey <String>]
   [-MicrosoftConfigAdvertisedPublicPrefixes <String[]>]
   [-MicrosoftConfigCustomerAsn <Int32>]
   [-MicrosoftConfigRoutingRegistryName <String>]
   [-PeerAddressType <String>]
   [-LegacyMode <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -PeeringType <String>
   -PeerASN <UInt32>
   -PrimaryPeerAddressPrefix <String>
   -SecondaryPeerAddressPrefix <String>
   -VlanId <Int32>
   [-SharedKey <String>]
   [-MicrosoftConfigAdvertisedPublicPrefixes <String[]>]
   [-MicrosoftConfigCustomerAsn <Int32>]
   [-MicrosoftConfigRoutingRegistryName <String>]
   -RouteFilterId <String>
   [-PeerAddressType <String>]
   [-LegacyMode <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -PeeringType <String>
   -PeerASN <UInt32>
   -PrimaryPeerAddressPrefix <String>
   -SecondaryPeerAddressPrefix <String>
   -VlanId <Int32>
   [-SharedKey <String>]
   [-MicrosoftConfigAdvertisedPublicPrefixes <String[]>]
   [-MicrosoftConfigCustomerAsn <Int32>]
   [-MicrosoftConfigRoutingRegistryName <String>]
   -RouteFilter <PSRouteFilter>
   [-PeerAddressType <String>]
   [-LegacyMode <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Set-AzExpressRouteCircuitPeeringConfig Cmdlet 會將修改過的 ExpressRoute 對等互連組態儲存回 Azure。

範例

範例 1：變更現有的對等互連設定

$circuit = Get-AzExpressRouteCircuit -Name $CircuitName -ResourceGroupName $rg
$parameters = @{
    Name = 'AzurePrivatePeering'
    Circuit = $circuit
    PeeringType = 'AzurePrivatePeering'
    PeerASN = 100
    PrimaryPeerAddressPrefix = '10.6.1.0/30'
    SecondaryPeerAddressPrefix = '10.6.2.0/30'
    VlanId  = 201
}
Set-AzExpressRouteCircuitPeeringConfig @parameters
Set-AzExpressRouteCircuit -ExpressRouteCircuit $circuit

範例 2

儲存修改過的 ExpressRoute 對等互連組態。 （ 自動產生 ）

Set-AzExpressRouteCircuitPeeringConfig -ExpressRouteCircuit <PSExpressRouteCircuit> -Name 'cert01' -PeerASN 100 -PeerAddressType IPv4 -PeeringType AzurePrivatePeering -PrimaryPeerAddressPrefix '123.0.0.0/30' -SecondaryPeerAddressPrefix '123.0.0.4/30' -VlanId 300

範例 3

儲存修改過的 ExpressRoute 對等互連組態。 （ 自動產生 ）

Set-AzExpressRouteCircuitPeeringConfig -ExpressRouteCircuit <PSExpressRouteCircuit> -MicrosoftConfigAdvertisedPublicPrefixes <String[]> -MicrosoftConfigCustomerAsn <Int32> -MicrosoftConfigRoutingRegistryName <String> -Name 'cert01' -PeerASN 100 -PeerAddressType IPv4 -PeeringType AzurePrivatePeering -PrimaryPeerAddressPrefix '123.0.0.0/30' -SecondaryPeerAddressPrefix '123.0.0.4/30' -VlanId 300

參數

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ExpressRouteCircuit

ExpressRoute 線路物件，其中包含要修改的對等互連組態。

類型:PSExpressRouteCircuit
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-LegacyMode

對等互連的舊版模式

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-MicrosoftConfigAdvertisedPublicPrefixes

針對 MicrosoftPeering 的 PeeringType，您必須提供您計畫透過 BGP 會話公告的所有前置詞清單。 只接受公用IP位址前綴。 如果您打算傳送一組前置詞，則可以傳送逗號分隔清單。 這些前置詞必須在路由登錄名稱 （RIR / IRR） 中向您註冊。

類型: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

輸入

PSExpressRouteCircuit

String

PSRouteFilter

Boolean

輸出

PSExpressRouteCircuit