Compartilhar via


Get-AzExpressRouteCircuitAuthorization

Obtém informações sobre as autorizações de circuito do ExpressRoute.

Sintaxe

Default (Default)

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 do ExpressRoute. Os circuitos do ExpressRoute conectam sua rede local à nuvem 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). As chaves de autorização, bem como outras informações sobre a autorização, podem ser exibidas a qualquer momento executando Get-AzExpressRouteCircuitAuthorization.

Exemplos

Exemplo 1: Obter todas as autorizações do ExpressRoute

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

Esses comandos retornam informações sobre todas as autorizações do ExpressRoute associadas a um circuito do ExpressRoute. O primeiro comando usa o cmdlet Get-AzExpressRouteCircuit para criar uma referência de objeto a um circuito chamado ContosoCircuit; essa referência de objeto é armazenada na variável $Circuit. Em seguida, o segundo comando usa essa referência de objeto e o cmdlet Get-AzExpressRouteCircuitAuthorization para retornar informações sobre as autorizações associadas à ContosoCircuit.

Exemplo 2: Obter todas as autorizações do ExpressRoute 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 nos 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 são canalizadas para o cmdlet Where-Object . Em seguida, Where-Object escolhe apenas as autorizações em que a propriedade AuthorizationUseStatus está definida como Disponível. 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.

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 a autorização do circuito do ExpressRoute.

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 do ExpressRoute que esse cmdlet obtém. -Nome "ContosoCircuitAuthorization"

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:False
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

PSExpressRouteCircuitAuthorization