Compartir a través de


Get-AzExpressRouteCircuitAuthorization

Obtiene información sobre las autorizaciones del circuito ExpressRoute.

Sintaxis

Default (valor predeterminado)

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.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ExpressRouteCircuit

Especifica la autorización del circuito ExpressRoute.

Propiedades de parámetro

Tipo:PSExpressRouteCircuit
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSExpressRouteCircuit

Salidas

PSExpressRouteCircuitAuthorization