Share via

Add-AzureRmExpressRouteCircuitAuthorization

  • Referenz
Modul:
AzureRM.Network

Fügt eine ExpressRoute-Schaltkreisautorisierung hinzu.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

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

Beschreibung

Das Add-AzureRmExpressRouteCircuitAuthorization-Cmdlet fügt eine Autorisierung zu einem ExpressRoute-Schaltkreis hinzu. ExpressRoute-Schaltkreise verbinden Ihr lokales Netzwerk mit der Microsoft-Cloud, indem sie einen Konnektivitätsanbieter anstelle des öffentlichen Internets verwenden. Der Besitzer eines ExpressRoute-Schaltkreises kann bis zu 10 Autorisierungen für jeden Schaltkreis erstellen; Diese Autorisierungen generieren einen Autorisierungsschlüssel, der von einem virtuellen Netzwerkbesitzer verwendet werden kann, um sein Netzwerk mit dem Schaltkreis (eine Autorisierung pro virtuellem Netzwerk) zu verbinden. Add-AzureRmExpressRouteCircuitAuthorization fügt eine neue Autorisierung zu einem Schaltkreis hinzu und generiert gleichzeitig den entsprechenden Autorisierungsschlüssel. Diese Schlüssel können jederzeit angezeigt werden, indem sie das Cmdlet Get-AzureRmExpressRouteCircuitAuthorization ausführen und nach Bedarf an den entsprechenden Netzwerkbesitzer kopiert und weitergeleitet werden. Beachten Sie, dass Sie nach dem Ausführen von Add-AzureRmExpressRouteCircuitAuthorization das Cmdlet Set-AzureRmExpressRouteCircuit aufrufen müssen, um den Schlüssel zu aktivieren. Wenn Sie "Set-AzureRmExpressRouteCircuit" nicht aufrufen, wird die Autorisierung dem Schaltkreis hinzugefügt, aber nicht für die Verwendung aktiviert.

Beispiele

Beispiel 1: Hinzufügen einer Autorisierung zum angegebenen ExpressRoute-Schaltkreis

$Circuit = Get-AzureRmExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Add-AzureRmExpressRouteCircuitAuthorization -Name "ContosoCircuitAuthorization" -Circuit $Circuit
Set-AzureRmExpressRouteCircuit -ExpressRouteCircuit $Circuit

Die Befehle in diesem Beispiel fügen einer vorhandenen ExpressRoute-Leitung eine neue Autorisierung hinzu. Der erste Befehl verwendet Get-AzureRmExpressRouteCircuit , um einen Objektverweis auf einen Schaltkreis namens ContosoCircuit zu erstellen. Dieser Objektverweis wird in einer Variablen namens $Circuit gespeichert. Im zweiten Befehl wird das Cmdlet "Add-AzureRmExpressRouteCircuitAuthorization " verwendet, um dem ExpressRoute-Schaltkreis eine neue Autorisierung (ContosoCircuitAuthorization) hinzuzufügen. Dieser Befehl fügt die Autorisierung hinzu, aktiviert diese Autorisierung jedoch nicht. Für die Aktivierung einer Autorisierung ist der im letzten Befehl im Beispiel gezeigte Set-AzureRmExpressRouteCircuit erforderlich.

Parameter

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

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

-ExpressRouteCircuit

Gibt den ExpressRoute-Schaltkreis an, dem dieses Cmdlet die Autorisierung hinzufügt.

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

-Name

Gibt den Namen der hinzuzufügenden Schaltkreisautorisierung an.

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

Eingaben

PSExpressRouteCircuit

Parameter: ExpressRouteCircuit (ByValue)

Ausgaben

PSExpressRouteCircuit