Compartir a través de

Add-AzureRmExpressRouteCircuitAuthorization

  • Referencia
Módulo:
AzureRM.Network

Agrega una autorización de circuito ExpressRoute.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente 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 se mantiene ni se admite, colocando cualquier uso continuado 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.

Syntax

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

Description

El cmdlet Add-AzureRmExpressRouteCircuitAuthorization agrega una autorización 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). Add-AzureRmExpressRouteCircuitAuthorization agrega una nueva autorización a un circuito y, al mismo tiempo, genera la clave de autorización correspondiente. Estas claves se pueden ver en cualquier momento ejecutando el cmdlet Get-AzureRmExpressRouteCircuitAuthorization y, según sea necesario, se pueden copiar y reenviar al propietario de red adecuado. Tenga en cuenta que, después de ejecutar Add-AzureRmExpressRouteCircuitAuthorization, debe llamar al cmdlet Set-AzureRmExpressRouteCircuit para activar la clave. Si no llama a Set-AzureRmExpressRouteCircuit , la autorización se agregará al circuito, pero no se habilitará para su uso.

Ejemplos

Ejemplo 1: Adición de una autorización al circuito ExpressRoute especificado

$Circuit = Get-AzureRmExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Add-AzureRmExpressRouteCircuitAuthorization -Name "ContosoCircuitAuthorization" -Circuit $Circuit
Set-AzureRmExpressRouteCircuit -ExpressRouteCircuit $Circuit

Los comandos de este ejemplo agregan una nueva autorización a un circuito ExpressRoute existente. El primer comando usa Get-AzureRmExpressRouteCircuit para crear una referencia de objeto a un circuito denominado ContosoCircuit. Esa referencia de objeto se almacena en una variable denominada $Circuit. En el segundo comando, el cmdlet Add-AzureRmExpressRouteCircuitAuthorization se usa para agregar una nueva autorización (ContosoCircuitAuthorization) al circuito ExpressRoute. Este comando agrega la autorización, pero no activa esa autorización. La activación de una autorización requiere set-AzureRmExpressRouteCircuit que se muestra en el comando final del ejemplo.

Parámetros

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpressRouteCircuit

Especifica el circuito ExpressRoute al que este cmdlet agrega la autorización.

Tipo:PSExpressRouteCircuit
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica el nombre de la autorización del circuito que se va a agregar.

Tipo:String
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSExpressRouteCircuit

Parámetros: ExpressRouteCircuit (ByValue)

Salidas

PSExpressRouteCircuit