你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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>]

说明

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 对象的资源 ID。

类型:	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 的 ID 号。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

输入

PSExpressRouteCircuit

String

PSRouteFilter

Boolean

输出