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

Get-AzPeering

获取具有给定订阅和资源组下指定名称的现有对等互连。

语法

Get-AzPeering
   [-SubscriptionId <String[]>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPeering
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String[]>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPeering
   -InputObject <IPeeringIdentity>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPeering
   -ResourceGroupName <String>
   [-SubscriptionId <String[]>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

说明

获取具有给定订阅和资源组下指定名称的现有对等互连。

示例

示例 1:列出所有对等互连

Get-AzPeering

Name           SkuName             Kind     PeeringLocation ProvisioningState Location
----           -------             ----     --------------- ----------------- --------
DemoComp1      Premium_Direct_Free Direct   Dallas          Succeeded         South Central US
DemoPeering    Premium_Direct_Free Direct   Dallas          Succeeded         South Central US
TestEdgeZone   Premium_Direct_Free Direct   Atlanta         Succeeded         East US 2
MapsIxRs       Premium_Direct_Free Direct   Ashburn         Succeeded         East US
DemoMapsConfig Premium_Direct_Free Direct   Seattle         Succeeded         West US 2
testexchange   Basic_Exchange_Free Exchange Amsterdam       Succeeded         West Europe
TestPeer1      Basic_Direct_Free   Direct   Amsterdam       Succeeded         West Europe
test1          Basic_Direct_Free   Direct   Athens          Succeeded         France Central

列出订阅中的所有对等互连

示例 2:按名称和资源组获取特定对等互连

Get-AzPeering -Name DemoPeering -ResourceGroupName DemoRG

Name        SkuName             Kind   PeeringLocation ProvisioningState Location
----        -------             ----   --------------- ----------------- --------
DemoPeering Premium_Direct_Free Direct Dallas          Succeeded         South Central US

按资源组和名称获取特定的对等互连

参数

-DefaultProfile

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

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

-InputObject

要构造的标识参数,请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

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

-Name

对等互连的名称。

Type:String
Aliases:PeeringName
Position:Named
Default value:None
Required:True
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

-SubscriptionId

Azure 订阅 ID。

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

输入

IPeeringIdentity

输出

IPeering

备注

别名

复杂参数属性

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

INPUTOBJECT <IPeeringIdentity>:标识参数

  • [ConnectionMonitorTestName <String>]:连接监视器测试的名称
  • [Id <String>]:资源标识路径
  • [PeerAsnName <String>]:对等 ASN 名称。
  • [PeeringName <String>]:对等互连的名称。
  • [PeeringServiceName <String>]:对等互连服务的名称。
  • [PrefixName <String>]:前缀的名称。
  • [RegisteredAsnName <String>]:已注册的 ASN 的名称。
  • [RegisteredPrefixName <String>]:已注册前缀的名称。
  • [ResourceGroupName <String>]:资源组的名称。
  • [SubscriptionId <String>]:Azure 订阅 ID。