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

New-AzPeering

  • 参考
模块:
Az.Peering

创建一个新的对等互连，或更新具有给定订阅和资源组下指定名称的现有对等互连。

语法

New-AzPeering
   -Name <String>
   -ResourceGroupName <String>
   -Kind <Kind>
   -Location <String>
   [-SubscriptionId <String>]
   [-DirectConnection <IDirectConnection[]>]
   [-DirectPeerAsnId <String>]
   [-DirectPeeringType <DirectPeeringType>]
   [-ExchangeConnection <IExchangeConnection[]>]
   [-ExchangePeerAsnId <String>]
   [-PeeringLocation <String>]
   [-Sku <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

说明

创建一个新的对等互连，或更新具有给定订阅和资源组下指定名称的现有对等互连。

示例

示例 1：创建新的直接对等互连对象

$peerAsnId = "/subscriptions/{subId}/providers/Microsoft.Peering/peerAsns/ContosoEdgeTest"
$directConnections = New-AzPeeringDirectConnectionObject -BandwidthInMbps 10000 -BgpSessionMaxPrefixesAdvertisedV4 20000

New-AzPeering -Name TestPeeringPs -ResourceGroupName DemoRG -Kind Direct -Location "South Central US" -DirectConnection $directConnections -DirectPeeringType Cdn -DirectPeerAsnId $peerAsnId -PeeringLocation Dallas -Sku Premium_Direct_Unlimited

Name        SkuName                  Kind   PeeringLocation ProvisioningState Location
----        -------                  ----   --------------- ----------------- --------
TestPeering Premium_Direct_Unlimited Direct Dallas          Succeeded         South Central US

创建新的直接对等互连对象

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DirectConnection

构成直接对等互连的连接集。 若要构造，请参阅 DIRECTCONNECTION 属性的 NOTES 部分并创建哈希表。

Type:IDirectConnection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DirectPeerAsnId

所引用资源的标识符。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DirectPeeringType

直接对等互连的类型。

Type:DirectPeeringType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExchangeConnection

构成交换对等互连的连接集。 若要构造，请参阅 EXCHANGECONNECTION 属性的 NOTES 部分并创建哈希表。

Type:IExchangeConnection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExchangePeerAsnId

所引用资源的标识符。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Kind

对等互连的类型。

Type:Kind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

资源的位置。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

对等互连的名称。

Type:String
Aliases:PeeringName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PeeringLocation

对等互连的位置。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

资源组的名称。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Sku

对等互连 SKU 的名称。

Type:String
Aliases:SkuName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Azure 订阅 ID。

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

资源标记。

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输出

IPeering

备注

别名

复杂参数属性

若要创建下面所述的参数，请构造一个包含相应属性的哈希表。 有关哈希表的信息，请运行 Get-Help about_Hash_Tables。

DIRECTCONNECTION <IDirectConnection[]>：构成直接对等互连的连接集。

  • [BandwidthInMbps <Int32?>]：连接的带宽。
  • [BgpSessionMaxPrefixesAdvertisedV4 <Int32?>]：通过 IPv4 会话播发的最大前缀数。
  • [BgpSessionMaxPrefixesAdvertisedV6 <Int32?>]：通过 IPv6 会话播发的最大前缀数。
  • [BgpSessionMd5AuthenticationKey <String>]：会话的 MD5 身份验证密钥。
  • [BgpSessionMicrosoftSessionIPv4Address <String>]：Microsoft 端的 IPv4 会话地址。
  • [BgpSessionMicrosoftSessionIPv6Address <String>]：Microsoft 端的 IPv6 会话地址。
  • [BgpSessionPeerSessionIPv4Address <String>]：对等端的 IPv4 会话地址。
  • [BgpSessionPeerSessionIPv6Address <String>]：对等端的 IPv6 会话地址。
  • [BgpSessionPrefixV4 <String>]：包含两端的 IPv4 地址的 IPv4 前缀。
  • [BgpSessionPrefixV6 <String>]：包含两端的 IPv6 地址的 IPv6 前缀。
  • [ConnectionIdentifier <String>]：连接的唯一标识符（GUID）。
  • [PeeringDbFacilityId <Int32?>]：必须设置连接的设施的 PeeringDB.com ID。
  • [SessionAddressProvider <SessionAddressProvider?>]：指示 Microsoft 是否提供会话 IP 地址的字段。
  • [UseForPeeringService <Boolean?>]：指示连接是否用于对等互连服务的标志。

EXCHANGECONNECTION <IExchangeConnection[]>：构成交换对等互连的连接集。

  • [BgpSessionMaxPrefixesAdvertisedV4 <Int32?>]：通过 IPv4 会话播发的最大前缀数。
  • [BgpSessionMaxPrefixesAdvertisedV6 <Int32?>]：通过 IPv6 会话播发的最大前缀数。
  • [BgpSessionMd5AuthenticationKey <String>]：会话的 MD5 身份验证密钥。
  • [BgpSessionMicrosoftSessionIPv4Address <String>]：Microsoft 端的 IPv4 会话地址。
  • [BgpSessionMicrosoftSessionIPv6Address <String>]：Microsoft 端的 IPv6 会话地址。
  • [BgpSessionPeerSessionIPv4Address <String>]：对等端的 IPv4 会话地址。
  • [BgpSessionPeerSessionIPv6Address <String>]：对等端的 IPv6 会话地址。
  • [BgpSessionPrefixV4 <String>]：包含两端的 IPv4 地址的 IPv4 前缀。
  • [BgpSessionPrefixV6 <String>]：包含两端的 IPv6 地址的 IPv6 前缀。
  • [ConnectionIdentifier <String>]：连接的唯一标识符（GUID）。
  • [PeeringDbFacilityId <Int32?>]：必须设置连接的设施的 PeeringDB.com ID。