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

Get-AzExpressRouteCircuitAuthorization

获取有关 ExpressRoute 线路授权的信息。

语法

Get-AzExpressRouteCircuitAuthorization
   [-Name <String>]
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

Get-AzExpressRouteCircuitAuthorization cmdlet 获取分配给 ExpressRoute 线路的授权的相关信息。 ExpressRoute 线路使用连接提供商而不是公共 Internet 将本地网络连接到 Microsoft 云。 ExpressRoute 线路的所有者可以为每个线路创建多达 10 个授权;这些授权生成一个授权密钥,虚拟网络所有者可以使用该密钥将他或她的网络连接到线路(每个虚拟网络一次授权)。 可以通过运行 Get-AzExpressRouteCircuitAuthorization 随时查看授权密钥以及有关授权的其他信息。

示例

示例 1:获取所有 ExpressRoute 授权

$Circuit = Get-AzExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Get-AzExpressRouteCircuitAuthorization -ExpressRouteCircuit $Circuit

这些命令返回与 ExpressRoute 线路关联的所有 ExpressRoute 授权的相关信息。 第一个命令使用 Get-AzExpressRouteCircuit cmdlet 创建对象引用名为 ContosoCircuit 的线路;该对象引用存储在变量$Circuit中。 然后,第二个命令使用该对象引用和 Get-AzExpressRouteCircuitAuthorization cmdlet 返回与 ContosoCircuit 关联的授权的相关信息。

示例 2:使用 Where-Object cmdlet 获取所有 ExpressRoute 授权

$Circuit = Get-AzExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
 Get-AzExpressRouteCircuitAuthorization -ExpressRouteCircuit $Circuit | Where-Object {$_.AuthorizationUseStatus -eq "Available"}

这些命令表示示例 1 中使用的命令的变体。 但是,在这种情况下,仅针对可供使用的授权(即尚未分配给虚拟网络的授权)返回信息。 为此,线路授权信息在命令 2 中返回,并通过管道传递给 Where-Object cmdlet。 然后,Where-Object 仅选取 AuthorizationUseStatus 属性设置为“可用”的授权。 若要仅列出不可用的授权,请对 Where 子句使用此语法: {$_.AuthorizationUseStatus -ne "Available"}

参数

-DefaultProfile

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

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ExpressRouteCircuit

指定 ExpressRoute 线路授权。

类型:PSExpressRouteCircuit
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

指定此 cmdlet 获取的 ExpressRoute 线路授权的名称。 -Name “ContosoCircuitAuthorization”

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

PSExpressRouteCircuit

输出

PSExpressRouteCircuitAuthorization