Partilhar via


Add-AzureRmExpressRouteCircuitAuthorization

Adiciona uma autorização de circuito de Rota Expressa.

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

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

Description

O cmdlet Add-AzureRmExpressRouteCircuitAuthorization adiciona uma autorização a um circuito ExpressRoute. Os circuitos de Rota Expressa conectam sua rede local à nuvem da Microsoft usando um provedor de conectividade em vez da Internet pública. O proprietário de um circuito de Rota Expressa pode criar até 10 autorizações para cada circuito; Essas autorizações geram uma chave de autorização que pode ser usada por um proprietário de rede virtual para conectar sua rede ao circuito (uma autorização por rede virtual). Add-AzureRmExpressRouteCircuitAuthorization adiciona uma nova autorização a um circuito e, ao mesmo tempo, gera a chave de autorização correspondente. Essas chaves podem ser exibidas a qualquer momento executando o cmdlet Get-AzureRmExpressRouteCircuitAuthorization e, conforme necessário, podem ser copiadas e encaminhadas para o proprietário da rede apropriado. Observe que, depois de executar Add-AzureRmExpressRouteCircuitAuthorization, você deve chamar o cmdlet Set-AzureRmExpressRouteCircuit para ativar a chave. Se você não chamar Set-AzureRmExpressRouteCircuit, a autorização será adicionada ao circuito, mas não será habilitada para uso.

Exemplos

Exemplo 1: Adicionar uma autorização ao circuito de Rota Expressa especificado

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

Os comandos neste exemplo adicionam uma nova autorização a um circuito de Rota Expressa existente. O primeiro comando usa Get-AzureRmExpressRouteCircuit para criar uma referência de objeto a um circuito chamado ContosoCircuit. Essa referência de objeto é armazenada em uma variável chamada $Circuit. No segundo comando, o cmdlet Add-AzureRmExpressRouteCircuitAuthorization é usado para adicionar uma nova autorização (ContosoCircuitAuthorization) ao circuito ExpressRoute. Este comando adiciona a autorização, mas não ativa essa autorização. A ativação de uma autorização requer o Set-AzureRmExpressRouteCircuit mostrado no comando final no exemplo.

Parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ExpressRouteCircuit

Especifica o circuito de Rota Expressa ao qual esse cmdlet adiciona a autorização.

Tipo:PSExpressRouteCircuit
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

Especifica o nome da autorização de circuito a ser adicionada.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

PSExpressRouteCircuit

Parâmetros: ExpressRouteCircuit (ByValue)

Saídas

PSExpressRouteCircuit