Get-AzureRmExpressRouteCircuitAuthorization
Obtém informações sobre autorizações de circuito da Rota Expressa.
Aviso
O módulo do PowerShell do AzureRM foi oficialmente preterido em 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.
Syntax
Get-AzureRmExpressRouteCircuitAuthorization
[-Name <String>]
-ExpressRouteCircuit <PSExpressRouteCircuit>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet Get-AzureRmExpressRouteCircuitAuthorization obtém informações sobre as autorizações atribuídas a um circuito de Rota Expressa. Os circuitos da 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). As chaves de autorização, bem como outras informações sobre a autorização, podem ser exibidas a qualquer momento executando Get-AzureRmExpressRouteCircuitAuthorization.
Exemplos
Exemplo 1: Obter todas as autorizações da Rota Expressa
$Circuit = Get-AzureRmExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Get-AzureRmExpressRouteCircuitAuthorization -Circuit $Circuit
Esses comandos retornam informações sobre todas as autorizações de Rota Expressa associadas a um circuito de Rota Expressa. O primeiro comando usa o cmdlet Get-AzureRmExpressRouteCircuit para criar uma referência de objeto a um circuito chamado ContosoCircuit; essa referência de objeto é armazenada na variável $Circuit. O segundo comando usa essa referência de objeto e o cmdlet Get-AzureRmExpressRouteCircuitAuthorization para retornar informações sobre as autorizações associadas a ContosoCircuit.
Exemplo 2: Obter todas as autorizações da Rota Expressa usando o cmdlet Where-Object
$Circuit = Get-AzureRmExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Get-AzureRmExpressRouteCircuitAuthorization -Circuit $Circuit | Where-Object {$_.AuthorizationUseStatus -eq "Available"}
Esses comandos representam uma variação dos comandos usados no Exemplo 1. Nesse caso, no entanto, as informações são retornadas apenas para as autorizações que estão disponíveis para uso (ou seja, para autorizações que não foram atribuídas a uma rede virtual). Para fazer isso, as informações de autorização de circuito são retornadas no comando 2 e são canalizadas para o cmdlet Where-Object .
Em seguida, Where-Object seleciona apenas as autorizações em que a propriedade AuthorizationUseStatus está definida como Available. Para listar apenas as autorizações que não estão disponíveis, use esta sintaxe para a cláusula Where: {$_.AuthorizationUseStatus -ne "Available"}
Parâmetros
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpressRouteCircuit
Especifica a autorização do circuito da Rota Expressa.
Type: | PSExpressRouteCircuit |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica o nome da autorização de circuito da Rota Expressa que esse cmdlet obtém. -Nome "ContosoCircuitAuthorization"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Parâmetros: ExpressRouteCircuit (ByValue)
Saídas
PSExpressRouteCircuitAuthorization