Partilhar via


Get-AzExpressRouteCircuitAuthorization

Obtém informações sobre autorizações de circuito de Rota Expressa.

Syntax

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

Description

O cmdlet Get-AzExpressRouteCircuitAuthorization obtém informações sobre as autorizações atribuídas a um circuito de Rota Expressa. 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). As chaves de autorização, bem como outras informações sobre a autorização, podem ser visualizadas a qualquer momento executando Get-AzExpressRouteCircuitAuthorization.

Exemplos

Exemplo 1: Obter todas as autorizações de Rota Expressa

$Circuit = Get-AzExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Get-AzExpressRouteCircuitAuthorization -ExpressRouteCircuit $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-AzExpressRouteCircuit para criar uma referência de objeto 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-AzExpressRouteCircuitAuthorization para retornar informações sobre as autorizações associadas a ContosoCircuit.

Exemplo 2: Obter todas as autorizações de Rota Expressa usando o cmdlet Where-Object

$Circuit = Get-AzExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
 Get-AzExpressRouteCircuitAuthorization -ExpressRouteCircuit $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 do circuito são retornadas no comando 2 e 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:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpressRouteCircuit

Especifica a autorização do circuito de 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 de 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

PSExpressRouteCircuit

Saídas

PSExpressRouteCircuitAuthorization