Get-AzExpressRouteCircuitAuthorization

  • Referencia
Módulo:
Az.Network

Obtiene información sobre las autorizaciones del circuito ExpressRoute.

Syntax

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

Description

El cmdlet Get-AzExpressRouteCircuitAuthorization obtiene información sobre las autorizaciones asignadas a un circuito ExpressRoute. Los circuitos ExpressRoute conectan la red local a la nube de Microsoft mediante un proveedor de conectividad en lugar de la red pública de Internet. El propietario de un circuito ExpressRoute puede crear hasta 10 autorizaciones para cada circuito; estas autorizaciones generan una clave de autorización que un propietario de red virtual puede usar para conectar su red al circuito (una autorización por red virtual). Las claves de autorización, así como otra información sobre la autorización, se pueden ver en cualquier momento ejecutando Get-AzExpressRouteCircuitAuthorization.

Ejemplos

Ejemplo 1: Obtención de todas las autorizaciones de ExpressRoute

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

Estos comandos devuelven información sobre todas las autorizaciones de ExpressRoute asociadas a un circuito ExpressRoute. El primer comando usa el cmdlet Get-AzExpressRouteCircuit para crear una referencia de objeto a un circuito denominado ContosoCircuit; esa referencia de objeto se almacena en la variable $Circuit. A continuación, el segundo comando usa esa referencia de objeto y el cmdlet Get-AzExpressRouteCircuitAuthorization para devolver información sobre las autorizaciones asociadas a ContosoCircuit.

Ejemplo 2: Obtención de todas las autorizaciones de ExpressRoute mediante el cmdlet Where-Object

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

Estos comandos representan una variación de los comandos usados en el ejemplo 1. En este caso, sin embargo, solo se devuelve información para aquellas autorizaciones que están disponibles para su uso (es decir, para las autorizaciones que no se han asignado a una red virtual). Para ello, la información de autorización del circuito se devuelve en el comando 2 y se canaliza al cmdlet Where-Object . Where-Object selecciona solo las autorizaciones en las que la propiedad AuthorizationUseStatus está establecida en Disponible. Para enumerar solo las autorizaciones que no están disponibles, use esta sintaxis para la cláusula Where: {$_.AuthorizationUseStatus -ne "Available"}

Parámetros

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpressRouteCircuit

Especifica la autorización del circuito ExpressRoute.

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

-Name

Especifica el nombre de la autorización del circuito ExpressRoute que obtiene este cmdlet. -Name "ContosoCircuitAuthorization"

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

Entradas

PSExpressRouteCircuit

Salidas

PSExpressRouteCircuitAuthorization