Get-AzExpressRouteCircuit
从 Azure 获取 Azure ExpressRoute 线路。
语法
Default （默认值）
Get-AzExpressRouteCircuit
[-Name <String>]
[-ResourceGroupName <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
说明
Get-AzExpressRouteCircuit cmdlet 用于从订阅中检索 ExpressRoute 线路对象。 返回的线路对象可用作对 ExpressRoute 线路运行的其他 cmdlet 的输入。
示例
示例 1：获取 ExpressRoute 线路
Get-AzExpressRouteCircuit -ResourceGroupName testrg -Name test
Name : test
ResourceGroupName : testrg
Location : southcentralus
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/pro
viders/Microsoft.Network/expressRouteCircuits/test
Etag : W/"00000000-0000-0000-0000-000000000000"
ProvisioningState : Succeeded
Sku : {
"Name": "Standard_UnlimitedData",
"Tier": "Standard",
"Family": "UnlimitedData"
}
CircuitProvisioningState : Enabled
ServiceProviderProvisioningState : NotProvisioned
ServiceProviderNotes :
ServiceProviderProperties : {
"ServiceProviderName": "AT&T",
"PeeringLocation": "Silicon Valley",
"BandwidthInMbps": 50
}
ExpressRoutePort : null
BandwidthInGbps :
Stag :
ServiceKey : 00000000-0000-0000-0000-000000000000
Peerings : []
Authorizations : []
AllowClassicOperations : False
GatewayManagerEtag :
获取名为“testrg”和 ResourceGroupName“test”的特定 ExpressRoute 线路
示例 2：使用筛选列出 ExpressRoute 线路
Get-AzExpressRouteCircuit -Name test*
Name : test1
ResourceGroupName : testrg
Location : southcentralus
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/pro
viders/Microsoft.Network/expressRouteCircuits/test1
Etag : W/"00000000-0000-0000-0000-000000000000"
ProvisioningState : Succeeded
Sku : {
"Name": "Standard_UnlimitedData",
"Tier": "Standard",
"Family": "UnlimitedData"
}
CircuitProvisioningState : Enabled
ServiceProviderProvisioningState : NotProvisioned
ServiceProviderNotes :
ServiceProviderProperties : {
"ServiceProviderName": "AT&T",
"PeeringLocation": "Silicon Valley",
"BandwidthInMbps": 50
}
ExpressRoutePort : null
BandwidthInGbps :
Stag :
ServiceKey : 00000000-0000-0000-0000-000000000000
Peerings : []
Authorizations : []
AllowClassicOperations : False
GatewayManagerEtag :
Name : test2
ResourceGroupName : testrg
Location : southcentralus
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/pro
viders/Microsoft.Network/expressRouteCircuits/test2
Etag : W/"00000000-0000-0000-0000-000000000000"
ProvisioningState : Succeeded
Sku : {
"Name": "Standard_UnlimitedData",
"Tier": "Standard",
"Family": "UnlimitedData"
}
CircuitProvisioningState : Enabled
ServiceProviderProvisioningState : NotProvisioned
ServiceProviderNotes :
ServiceProviderProperties : {
"ServiceProviderName": "AT&T",
"PeeringLocation": "Silicon Valley",
"BandwidthInMbps": 50
}
ExpressRoutePort : null
BandwidthInGbps :
Stag :
ServiceKey : 00000000-0000-0000-0000-000000000000
Peerings : []
Authorizations : []
AllowClassicOperations : False
GatewayManagerEtag :
获取名称以“test”开头的所有 ExpressRoute 线路。
参数
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
参数属性
| 类型: | IAzureContextContainer |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | AzContext, AzureRmContext, AzureCredential |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
ExpressRoute 线路的名称。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
| 别名: | 资源名称 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-ResourceGroupName
包含 ExpressRoute 线路的资源组的名称。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
