你当前正在访问 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
此参数的可接受值为: 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 |
输入
参数:ExpressRouteCircuit (ByValue)