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

Get-AzPeeringRegisteredPrefix

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

语法

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

说明

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

示例

示例 1:列出对等互连的所有已注册前缀

Get-AzPeeringRegisteredPrefix -PeeringName DemoPeering -ResourceGroupName DemoRG

Name                  Prefix       PeeringServicePrefixKey              PrefixValidationState ProvisioningState
----                  ------       -----------------------              --------------------- -----------------
accessibilityTesting1 240.0.0.0/24 f5947454-80e3-4ce5-bcb3-2501537b6952 Failed                Succeeded
accessibilityTesting2 240.0.1.0/24 249aa0dd-6177-4105-94fe-dfefcbf5ab48 Failed                Succeeded
accessibilityTesting3 240.0.2.0/24 4fb59e9e-d4eb-4847-b2ad-9939edda750b Failed                Succeeded
accessibilityTesting4 240.0.4.0/24 b725f16c-759b-4144-93ed-ed4eb89cb8f7 Failed                Succeeded
accessibilityTesting5 240.0.3.0/24 bb1262ca-0b31-45f3-a301-105b0615b21c Failed                Succeeded

列出所有已注册的前缀

示例 2:获取对等互连的特定注册前缀

Get-AzPeeringRegisteredPrefix -PeeringName DemoPeering -ResourceGroupName DemoRG -Name accessibilityTesting1

Name                  Prefix       PeeringServicePrefixKey              PrefixValidationState ProvisioningState
----                  ------       -----------------------              --------------------- -----------------
accessibilityTesting1 240.0.0.0/24 f5947454-80e3-4ce5-bcb3-2501537b6952 Failed                Succeeded

按名称获取特定的已注册前缀

参数

-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:RegisteredPrefixName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PeeringName

对等互连的名称。

Type:String
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

输出

IPeeringRegisteredPrefix

备注

别名

复杂参数属性

若要创建下面所述的参数,请构造一个包含相应属性的哈希表。 有关哈希表的信息,请运行 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。