Compartir a través de

Get-AzureRmExpressRouteCircuitAuthorization

  • Referencia
Módulo:
AzureRM.Network

Obtiene información sobre las autorizaciones del circuito ExpressRoute.

Advertencia

El módulo AzureRM PowerShell ha quedado oficialmente obsoleto a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

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

Description

El cmdlet Get-AzureRmExpressRouteCircuitAuthorization 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 mediante la ejecución de Get-AzureRmExpressRouteCircuitAuthorization.

Ejemplos

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

$Circuit = Get-AzureRmExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Get-AzureRmExpressRouteCircuitAuthorization -Circuit $Circuit

Estos comandos devuelven información sobre todas las autorizaciones de ExpressRoute asociadas a un circuito ExpressRoute. El primer comando usa el cmdlet Get-AzureRmExpressRouteCircuit 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-AzureRmExpressRouteCircuitAuthorization 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-AzureRmExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
 Get-AzureRmExpressRouteCircuitAuthorization -Circuit $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.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExpressRouteCircuit

Especifica la autorización del circuito ExpressRoute.

Tipo:PSExpressRouteCircuit
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

PSExpressRouteCircuit

Parámetros: ExpressRouteCircuit (ByValue)

Salidas

PSExpressRouteCircuitAuthorization