Compartilhar via


Add-AzExpressRouteCircuitAuthorization

Adiciona uma autorização de circuito do ExpressRoute.

Sintaxe

Default (Default)

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

Description

O cmdlet Add-AzExpressRouteCircuitAuthorization adiciona uma autorização a um circuito do ExpressRoute. Os circuitos do ExpressRoute conectam sua rede local à nuvem da Microsoft usando um provedor de conectividade em vez da Internet pública. O proprietário de um circuito do ExpressRoute 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-AzExpressRouteCircuitAuthorization 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-AzExpressRouteCircuitAuthorization e, conforme necessário, podem ser copiadas e encaminhadas para o proprietário de rede apropriado. Observe que, depois de executar Add-AzExpressRouteCircuitAuthorization, você deve chamar o cmdlet Set-AzExpressRouteCircuit para ativar a chave. Se você não chamar Set-AzExpressRouteCircuit , a autorização será adicionada ao circuito, mas não será habilitada para uso.

Exemplos

Exemplo 1: adicionar uma autorização ao circuito do ExpressRoute especificado

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

Os comandos neste exemplo adicionam uma nova autorização a um circuito existente do ExpressRoute. O primeiro comando usa Get-AzExpressRouteCircuit 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-AzExpressRouteCircuitAuthorization é usado para adicionar uma nova autorização (ContosoCircuitAuthorization) ao circuito do ExpressRoute. Esse comando adiciona a autorização, mas não ativa essa autorização. A ativação de uma autorização requer o Set-AzExpressRouteCircuit 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.

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExpressRouteCircuit

Especifica o circuito do ExpressRoute ao qual esse cmdlet adiciona a autorização.

Propriedades do parâmetro

Tipo:PSExpressRouteCircuit
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSExpressRouteCircuit

Saídas

PSExpressRouteCircuit