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>]
   [-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>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-AzExpressRoutePort cmdlet creates an Azure ExpressRoutePort

Examples

Example 1

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

Example 2

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

Parameters

-AsJob

Run cmdlet in the background

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

Bandwidth of procured ports in Gbps

Type:Int32
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

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

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

Type:Microsoft.Azure.Commands.Common.Authentication.Abstractions.Core.IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Encapsulation

Encapsulation method on physical ports.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Force

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

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

User Assigned Identity for reading MacSec configuration

Type:Microsoft.Azure.Commands.Network.Models.PSManagedServiceIdentity
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Link

The set of physical links of the ExpressRoutePort resource

Type:Microsoft.Azure.Commands.Network.Models.PSExpressRouteLink[]
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Location

The location.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Name

The name of the ExpressRoutePort.

Type:String
Aliases:ResourceName
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
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
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ResourceGroupName

The resource group name of the ExpressRoutePort.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ResourceId

ResourceId of the express route port.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Tag

A hashtable which represents resource tags.

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
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
Accept pipeline input:False
Accept wildcard characters:False

Inputs

String

Int32

Hashtable

Microsoft.Azure.Commands.Network.Models.PSExpressRouteLink[]

Outputs

Microsoft.Azure.Commands.Network.Models.PSExpressRoutePort