< Back
New-AzureRmExpressRouteCircuit
Post
NAME New-AzureRmExpressRouteCircuit
SYNOPSIS
Creates an Azure express route circuit.
SYNTAX
New-AzureRmExpressRouteCircuit [-AllowClassicOperations <Boolean>] [-AsJob] [-Authorization
<System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSExpressRouteCircuitAuthorization]>] -BandwidthInMbps <Int32>
[-DefaultProfile <IAzureContextContainer>] [-Force] -Location <String> -Name <String> [-Peering
<System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPeering]>] -PeeringLocation <String> -ResourceGroupName <String>
-ServiceProviderName <String> [-SkuFamily {MeteredData | UnlimitedData}] [-SkuTier {Standard | Premium}] [-Tag <Hashtable>] [-Confirm] [-WhatIf]
[<CommonParameters>]
DESCRIPTION
The New-AzureRmExpressRouteCircuit cmdlet creates an Azure express route circuit.
PARAMETERS
-AllowClassicOperations <Boolean>
The use of this parameter allows you to use the classic Azure PowerShell cmdlets to manage the circuit.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-AsJob [<SwitchParameter>]
Run cmdlet in the background
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Authorization <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSExpressRouteCircuitAuthorization]>
A list of circuit authorizations.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-BandwidthInMbps <Int32>
The bandwidth of the circuit. This must be a value that is supported by the service provider.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Force [<SwitchParameter>]
Forces the command to run without asking for user confirmation.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Location <String>
The location of the circuit.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Name <String>
The name of the ExpressRoute circuit being created.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Peering <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPeering]>
A list peer configurations.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-PeeringLocation <String>
The name of the peering location supported by the service provider.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ResourceGroupName <String>
The resource group that will contain the circuit.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ServiceProviderName <String>
The name of the circuit service provider. This must match a name listed by the Get-AzureRmExpressRouteServiceProvider cmdlet.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-SkuFamily <String>
SKU family determines the billing type. Possible values for this parameter are: `MeteredData` or `UnlimitedData`. Note that you can change the
billing type from MeteredData to UnlimitedData, but you can't change the type from UnlimitedData to MeteredData.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-SkuTier <String>
The tier of service for the circuit. Possible values for this parameter are: `Standard` or `Premium`.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Tag <Hashtable>
Key-value pairs in the form of a hash table. For example:
@{key0="value0";key1=$null;key2="value2"}
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
This cmdlet does not accept any input.
OUTPUTS
Microsoft.Azure.Commands.Network.Models.PSExpressRouteCircuit
NOTES
Example 1: Create a new ExpressRoute circuit
$parameters = @{
Name='ExpressRouteCircuit'
ResourceGroupName='ExpressRouteResourceGroup'
Location='West US'
SkuTier='Standard'
SkuFamily='MeteredData'
ServiceProviderName='Equinix'
PeeringLocation='Silicon Valley'
BandwidthInMbps=200
}
New-AzureRmExpressRouteCircuit @parameters
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... utecircuit
Get-AzureRmExpressRouteCircuit
Move-AzureRmExpressRouteCircuit
Remove-AzureRmExpressRouteCircuit
Set-AzureRmExpressRouteCircuit
SYNOPSIS
Creates an Azure express route circuit.
SYNTAX
New-AzureRmExpressRouteCircuit [-AllowClassicOperations <Boolean>] [-AsJob] [-Authorization
<System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSExpressRouteCircuitAuthorization]>] -BandwidthInMbps <Int32>
[-DefaultProfile <IAzureContextContainer>] [-Force] -Location <String> -Name <String> [-Peering
<System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPeering]>] -PeeringLocation <String> -ResourceGroupName <String>
-ServiceProviderName <String> [-SkuFamily {MeteredData | UnlimitedData}] [-SkuTier {Standard | Premium}] [-Tag <Hashtable>] [-Confirm] [-WhatIf]
[<CommonParameters>]
DESCRIPTION
The New-AzureRmExpressRouteCircuit cmdlet creates an Azure express route circuit.
PARAMETERS
-AllowClassicOperations <Boolean>
The use of this parameter allows you to use the classic Azure PowerShell cmdlets to manage the circuit.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-AsJob [<SwitchParameter>]
Run cmdlet in the background
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Authorization <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSExpressRouteCircuitAuthorization]>
A list of circuit authorizations.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-BandwidthInMbps <Int32>
The bandwidth of the circuit. This must be a value that is supported by the service provider.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Force [<SwitchParameter>]
Forces the command to run without asking for user confirmation.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Location <String>
The location of the circuit.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Name <String>
The name of the ExpressRoute circuit being created.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Peering <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPeering]>
A list peer configurations.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-PeeringLocation <String>
The name of the peering location supported by the service provider.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ResourceGroupName <String>
The resource group that will contain the circuit.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ServiceProviderName <String>
The name of the circuit service provider. This must match a name listed by the Get-AzureRmExpressRouteServiceProvider cmdlet.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-SkuFamily <String>
SKU family determines the billing type. Possible values for this parameter are: `MeteredData` or `UnlimitedData`. Note that you can change the
billing type from MeteredData to UnlimitedData, but you can't change the type from UnlimitedData to MeteredData.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-SkuTier <String>
The tier of service for the circuit. Possible values for this parameter are: `Standard` or `Premium`.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Tag <Hashtable>
Key-value pairs in the form of a hash table. For example:
@{key0="value0";key1=$null;key2="value2"}
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
This cmdlet does not accept any input.
OUTPUTS
Microsoft.Azure.Commands.Network.Models.PSExpressRouteCircuit
NOTES
Example 1: Create a new ExpressRoute circuit
$parameters = @{
Name='ExpressRouteCircuit'
ResourceGroupName='ExpressRouteResourceGroup'
Location='West US'
SkuTier='Standard'
SkuFamily='MeteredData'
ServiceProviderName='Equinix'
PeeringLocation='Silicon Valley'
BandwidthInMbps=200
}
New-AzureRmExpressRouteCircuit @parameters
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... utecircuit
Get-AzureRmExpressRouteCircuit
Move-AzureRmExpressRouteCircuit
Remove-AzureRmExpressRouteCircuit
Set-AzureRmExpressRouteCircuit