Add-AzExpressRoutePortAuthorization
Fügt eine ExpressRoutePort-Autorisierung hinzu.
Syntax
Add-AzExpressRoutePortAuthorization
-Name <String>
-ExpressRoutePortObject <PSExpressRoutePort>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Add-AzExpressRoutePortAuthorization-Cmdlet fügt einem ExpressRoutePort eine Autorisierung hinzu. Der Besitzer eines ExpressRoutePorts kann diese Autorisierungen erstellen, die einen Autorisierungsschlüssel generieren, der von einem ExpressRoute-Schaltkreisbesitzer verwendet werden kann, um den Schaltkreis auf dem ExpressRoutePort (mit einem anderen Besitzer) zu erstellen. Es kann nur ein Schaltkreis mit einer ExpressRoutePort-Autorisierung erstellt werden.Add-AzExpressRoutePortAuthorization fügt einem ExpressRoutePort eine neue Autorisierung hinzu und generiert gleichzeitig den entsprechenden Autorisierungsschlüssel. Diese Schlüssel können jederzeit angezeigt werden, indem sie das Cmdlet Get-AzExpressRoutePortAuthorization ausführen und nach Bedarf an den entsprechenden Schaltkreisbesitzer kopiert und weitergeleitet werden.
Beispiele
Beispiel 1
$ERPort = Get-AzExpressRoutePort -Name "ContosoPort" -ResourceGroupName "ContosoResourceGroup"
Name : ContosoPort
ResourceGroupName : ContosoResourceGroup
Location : westcentralus
Id : /subscriptions/62364504-2406-418e-971c-05822ff72fad/resourceGroups/ContosoResourceGroup/pr
oviders/Microsoft.Network/expressRoutePorts/ContosoPort
Etag : W/"cf987288-013e-40bf-a2aa-b29d017e7b7f"
ResourceGuid : 4c0e5cdb-79e1-4cb8-a430-0ce9b24472ca
ProvisioningState : Succeeded
PeeringLocation : Area51-ERDirect
BandwidthInGbps : 100
ProvisionedBandwidthInGbps : 0
Encapsulation : QinQ
Mtu : 1500
EtherType : 0x8100
AllocationDate : Thursday, March 31, 2022
Identity : null
Links : [
{
"Name": "link1",
"Etag": "W/\"cf987288-013e-40bf-a2aa-b29d017e7b7f\"",
"Id": "/subscriptions/62364504-2406-418e-971c-05822ff72fad/resourceGroups/ContosoResou
rceGroup/providers/Microsoft.Network/expressRoutePorts/ContosoPort/links/link1",
"RouterName": "a51-test-06gmr-cis-3",
"InterfaceName": "HundredGigE15/15/19",
"PatchPanelId": "PP:0123:1110201 - Port 42",
"RackId": "A51 02050-0123-L",
"ConnectorType": "LC",
"AdminState": "Disabled",
"ProvisioningState": "Succeeded",
"MacSecConfig": {
"SciState": "Disabled",
"Cipher": "GcmAes128"
}
},
{
"Name": "link2",
"Etag": "W/\"cf987288-013e-40bf-a2aa-b29d017e7b7f\"",
"Id": "/subscriptions/62364504-2406-418e-971c-05822ff72fad/resourceGroups/ContosoResou
rceGroup/providers/Microsoft.Network/expressRoutePorts/ContosoPort/links/link2",
"RouterName": "a51-test-06gmr-cis-4",
"InterfaceName": "HundredGigE15/15/19",
"PatchPanelId": "2050:0124:1110854 - Port 42",
"RackId": "A51 02050-0124-L",
"ConnectorType": "LC",
"AdminState": "Disabled",
"ProvisioningState": "Succeeded",
"MacSecConfig": {
"SciState": "Disabled",
"Cipher": "GcmAes128"
}
}
]
Circuits : []
Add-AzExpressRoutePortAuthorization -Name "ContosoPortAuthorization" -ExpressRoutePortObject $ERPort
Name : ContosoPortAuthorization
Id : /subscriptions/62364504-2406-418e-971c-05822ff72fad/resourceGroups/ContosoResourceGroup/provid
ers/Microsoft.Network/expressRoutePorts/ContosoPort/authorizations/ContosoPortAuthorization
Etag : W/"36ccc199-c371-4d19-88cc-90d51bfe7ea9"
AuthorizationKey : 10d01cd7-0b67-4c44-88ca-51e7effa452d
AuthorizationUseStatus : Available
ProvisioningState : Succeeded
CircuitResourceUri :
Mit den Befehlen in diesem Beispiel wird einem vorhandenen ExpressRoutePort eine neue Autorisierung hinzugefügt. Der erste Befehl verwendet Get-AzExpressRoutePort , um einen Objektverweis auf einen ExpressRoutePort namens ContosoPort zu erstellen. Dieser Objektverweis wird in einer Variablen namens $ERPort gespeichert. Im zweiten Befehl wird das Cmdlet Add-AzExpressRoutePortAuthorization verwendet, um dem ExpressRoutePort eine neue Autorisierung (ContosoPortAuthorization) hinzuzufügen.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Typ: | IAzureContextContainer |
Aliase: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ExpressRoutePortObject
Das ExpressRoutePort-Objekt
Typ: | PSExpressRoutePort |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Name
Gibt einen eindeutigen Namen für die neue ExpressRoutePort-Autorisierung an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
Ausgaben
PSExpressRoutePortAuthorization