New-AzureRmExpressRouteCircuit

Referenz

Modul:: AzureRM.Network

Erstellt einen Azure Express-Routenkreis.

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

New-AzureRmExpressRouteCircuit
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   [-SkuTier <String>]
   [-SkuFamily <String>]
   [-ServiceProviderName <String>]
   [-PeeringLocation <String>]
   [-BandwidthInMbps <Int32>]
   [-Peering <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPeering]>]
   [-Authorization <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSExpressRouteCircuitAuthorization]>]
   [-AllowClassicOperations <Boolean>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmExpressRouteCircuit
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   [-SkuTier <String>]
   [-SkuFamily <String>]
   [-ExpressRoutePort <PSExpressRoutePort>]
   [-BandwidthInGbps <Double>]
   [-Peering <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPeering]>]
   [-Authorization <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSExpressRouteCircuitAuthorization]>]
   [-AllowClassicOperations <Boolean>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzureRmExpressRouteCircuit erstellt einen Azure Express-Routenkreis.

Beispiele

Beispiel 1: Erstellen eines neuen ExpressRoute-Schaltkreises

$parameters = @{
    Name='ExpressRouteCircuit'
    ResourceGroupName='ExpressRouteResourceGroup'
    Location='West US'
    SkuTier='Standard'
    SkuFamily='MeteredData'
    ServiceProviderName='Equinix'
    PeeringLocation='Silicon Valley'
    BandwidthInMbps=200
}
New-AzureRmExpressRouteCircuit @parameters

Beispiel 2: Erstellen eines neuen ExpressRoute-Schaltkreises auf ExpressRoutePort

$parameters = @{
    Name='ExpressRouteCircuit'
    ResourceGroupName='ExpressRouteResourceGroup'
    Location='West US'
    SkuTier='Standard'
    SkuFamily='MeteredData'
    ExpressRoutePort=$PSExpressRoutePort
    BandwidthInGbps=10.0
}
New-AzureRmExpressRouteCircuit @parameters

Parameter

-AllowClassicOperations

Mithilfe dieses Parameters können Sie die klassischen Azure PowerShell-Cmdlets verwenden, um den Schaltkreis zu verwalten.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-AsJob

Cmdlet im Hintergrund ausführen

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

-Authorization

Eine Liste der Schaltkreisautorisierungen.

Type:	List<T>[PSExpressRouteCircuitAuthorization]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-BandwidthInGbps

Die Bandbreite des Schaltkreises, wenn der Schaltkreis in einer ExpressRoutePort-Ressource bereitgestellt wird.

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

-BandwidthInMbps

Die Bandbreite des Schaltkreises. Dies muss ein Wert sein, der vom Dienstanbieter unterstützt wird.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-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

-ExpressRoutePort

Der Verweis auf die ExpressRoutePort-Ressource, wenn der Schaltkreis in einer ExpressRoutePort-Ressource bereitgestellt wird.

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-Location

Die Position des Schaltkreises.

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

-Name

Der Name des erstellten ExpressRoute-Schaltkreises.

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

-Peering

Eine Listenspeerkonfiguration.

Type:	List<T>[PSPeering]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PeeringLocation

Der Name des peering-Speicherorts, der vom Dienstanbieter unterstützt wird.

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

-ResourceGroupName

Die Ressourcengruppe, die den Schaltkreis enthält.

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

-ServiceProviderName

Der Name des Schaltkreisdienstanbieters. Dies muss mit einem Namen übereinstimmen, der vom Cmdlet Get-AzureRmExpressRouteServiceProvider aufgeführt ist.

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

-SkuFamily

Die SKU-Familie bestimmt den Abrechnungstyp. Mögliche Werte für diesen Parameter sind: MeteredData oder UnlimitedData. Beachten Sie, dass Sie den Abrechnungstyp von "MeteredData" in "UnlimitedData" ändern können, aber Sie können den Typ von "UnlimitedData" in "MeteredData" nicht ändern.

Type:	String
Accepted values:	MeteredData, UnlimitedData
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SkuTier

Die Dienstebene für den Schaltkreis. Mögliche Werte für diesen Parameter sind: Standard oder Premium.

Type:	String
Accepted values:	Standard, Premium
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Schlüssel-Wert-Paare in Form einer Hashtabelle. Beispiel: @{key0="value0"; key1=$null; key2="value2"}

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

String

Int32

List<T>[[Microsoft.Azure.Commands.Network.Models.PSPeering, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSExpressRouteCircuitAuthorization, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Hashtable

Ausgaben

PSExpressRouteCircuit