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

Set-AzureRmExpressRouteCircuitPeeringConfig

保存修改后的 ExpressRoute 对等互连配置。

警告

截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行,但它不再维护或受支持,但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源

语法

Set-AzureRmExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -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>]
Set-AzureRmExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -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>]
Set-AzureRmExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -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>]

说明

Set-AzureRmExpressRouteCircuitPeeringConfig cmdlet 会将修改后的 ExpressRoute 对等互连配置保存回 Azure。

示例

示例 1:更改现有的对等互连配置

$circuit = Get-AzureRmExpressRouteCircuit -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-AzureRmExpressRouteCircuitPeeringConfig @parameters
Set-AzureRmExpressRouteCircuit -ExpressRouteCircuit $circuit

参数

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名: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)中注册这些前缀。

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

此参数的可接受值为: AzurePrivatePeeringAzurePublicPeeringMicrosoftPeering

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

参数:ExpressRouteCircuit (ByValue)

String

PSRouteFilter

Boolean

输出

PSExpressRouteCircuit