Get-AzExpressRouteCircuitAuthorization

  • Referentie
Module:
Az.Network

Hiermee wordt informatie opgehaald over autorisaties van ExpressRoute-circuits.

Syntax

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

Description

De cmdlet Get-AzExpressRouteCircuitAuthorization haalt informatie op over de autorisaties die zijn toegewezen aan een ExpressRoute-circuit. ExpressRoute-circuits verbinden uw on-premises netwerk met de Microsoft-cloud met behulp van een connectiviteitsprovider in plaats van het openbare internet. De eigenaar van een ExpressRoute-circuit kan maximaal 10 autorisaties maken voor elk circuit; deze autorisaties genereren een autorisatiesleutel die kan worden gebruikt door een eigenaar van een virtueel netwerk om zijn of haar netwerk te verbinden met het circuit (één autorisatie per virtueel netwerk). Autorisatiesleutels, evenals andere informatie over de autorisatie, kunnen op elk gewenst moment worden weergegeven door Get-AzExpressRouteCircuitAuthorization uit te voeren.

Voorbeelden

Voorbeeld 1: Alle ExpressRoute-autorisaties ophalen

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

Met deze opdrachten wordt informatie geretourneerd over alle ExpressRoute-autorisaties die zijn gekoppeld aan een ExpressRoute-circuit. De eerste opdracht maakt gebruik van de cmdlet Get-AzExpressRouteCircuit om een objectverwijzing te maken naar een circuit met de naam ContosoCircuit. Deze objectverwijzing wordt opgeslagen in de variabele $Circuit. De tweede opdracht gebruikt vervolgens die objectverwijzing en de Get-AzExpressRouteCircuitAuthorization-cmdlet om informatie te retourneren over de autorisaties die zijn gekoppeld aan ContosoCircuit.

Voorbeeld 2: Alle ExpressRoute-autorisaties ophalen met behulp van de cmdlet Where-Object

$Circuit = Get-AzExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
 Get-AzExpressRouteCircuitAuthorization -ExpressRouteCircuit $Circuit | Where-Object {$_.AuthorizationUseStatus -eq "Available"}

Deze opdrachten vertegenwoordigen een variatie op de opdrachten die worden gebruikt in voorbeeld 1. In dit geval wordt echter alleen informatie geretourneerd voor de autorisaties die beschikbaar zijn voor gebruik (dat wil gezegd, voor autorisaties die niet zijn toegewezen aan een virtueel netwerk). Hiervoor wordt de circuitautorisatie-informatie geretourneerd in opdracht 2 en wordt doorgesluisd naar de cmdlet Where-Object . Where-Object kiest vervolgens alleen de autorisaties waarvoor de eigenschap AuthorizationUseStatus is ingesteld op Beschikbaar. Als u alleen de autorisaties wilt weergeven die niet beschikbaar zijn, gebruikt u deze syntaxis voor de Where-component: {$_.AuthorizationUseStatus -ne "Available"}

Parameters

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpressRouteCircuit

Hiermee geeft u de autorisatie van het ExpressRoute-circuit op.

Type:PSExpressRouteCircuit
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van de ExpressRoute-circuitautorisatie op die door deze cmdlet wordt verkregen. -Name "ContosoCircuitAuthorization"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

PSExpressRouteCircuit

Uitvoerwaarden

PSExpressRouteCircuitAuthorization