New-AzExpressRoutePort

Creates an Azure ExpressRoutePort.

Syntax

New-AzExpressRoutePort
   -ResourceGroupName <String>
   -Name <String>
   -PeeringLocation <String>
   -BandwidthInGbps <Int32>
   -Encapsulation <String>
   -Location <String>
   [-Tag <Hashtable>]
   [-Link <PSExpressRouteLink[]>]
   [-Force]
   [-AsJob]
   [-Identity <PSManagedServiceIdentity>]
   [-BillingType <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzExpressRoutePort
   -ResourceId <String>
   -PeeringLocation <String>
   -BandwidthInGbps <Int32>
   -Encapsulation <String>
   -Location <String>
   [-Tag <Hashtable>]
   [-Link <PSExpressRouteLink[]>]
   [-Force]
   [-AsJob]
   [-Identity <PSManagedServiceIdentity>]
   [-BillingType <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-AzExpressRoutePort cmdlet creates an Azure ExpressRoutePort

Examples

Example 1

$parameters = @{
    Name='ExpressRoutePort'
    ResourceGroupName='ExpressRouteResourceGroup'
    Location='West US'
    PeeringLocation='Silicon Valley'
    BandwidthInGbps=100
    Encapsulation='QinQ'
}
New-AzExpressRoutePort @parameters

Example 2

$parameters = @{
    ResourceId='/subscriptions/<SubId>/resourceGroups/<ResourceGroupName>/providers/Microsoft.Network/expressRoutePorts/<PortName>'
    Location='West US'
    PeeringLocation='Silicon Valley'
    BandwidthInGbps=100
    Encapsulation='QinQ'
}
New-AzExpressRoutePort @parameters

Parameters

-AsJob

Run cmdlet in the background

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

-BandwidthInGbps

Bandwidth of procured ports in Gbps

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

-BillingType

Billing type of the port

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

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

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

-Encapsulation

Encapsulation method on physical ports.

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

-Force

Do not ask for confirmation if you want to overwrite a resource

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

-Identity

User Assigned Identity for reading MacSec configuration

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

The set of physical links of the ExpressRoutePort resource

Type:PSExpressRouteLink[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

The location.

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

-Name

The name of the ExpressRoutePort.

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

-PeeringLocation

The name of the peering location that the ExpressRoutePort is mapped to physically.

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

-ResourceGroupName

The resource group name of the ExpressRoutePort.

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

-ResourceId

ResourceId of the express route port.

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

-Tag

A hashtable which represents resource tags.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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

Inputs

String

Int32

Hashtable

PSExpressRouteLink[]

Outputs

PSExpressRoutePort