Commands › Microsoft Teams

New-CsOnlineDirectRoutingTelephoneNumberUploadOrder

Microsoft Teams MicrosoftTeams New-*

This cmdlet creates a request to upload Direct Routing telephone numbers to Microsoft Teams telephone number management inventory.

Quick start script

# New-CsOnlineDirectRoutingTelephoneNumberUploadOrder — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsOnlineDirectRoutingTelephoneNumberUploadOrder
$before | Format-List

# 3. Make the change
New-CsOnlineDirectRoutingTelephoneNumberUploadOrder

# 4. Verify and diff
$after = Get-CsOnlineDirectRoutingTelephoneNumberUploadOrder
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax — 3 parameter sets

InputByList (Default)

New-CsOnlineDirectRoutingTelephoneNumberUploadOrder 
    [-TelephoneNumber <String>] 
    [-LocationId <String>]
    [-AcquiredCapability <String>] 
    [-NetworkSiteId <String>] 
    [-ReverseNumberLookup <String>] 
    [-Tag <String>]
    [<CommonParameters>]

InputByRange

New-CsOnlineDirectRoutingTelephoneNumberUploadOrder 
    [-LocationId <String>] 
    [-AcquiredCapability <String>]
    [-NetworkSiteId <String>] 
    [-ReverseNumberLookup <String>] 
    [-Tag <String>]
    [-StartingNumber <String>] 
    [-EndingNumber <String>]
    [<CommonParameters>]

InputByFile

New-CsOnlineDirectRoutingTelephoneNumberUploadOrder 
    [-FileContent <Byte[]>] 
    [<CommonParameters>]

Parameters (9)

Parameter	Type	What it controls
-AcquiredCapability	String	This is the list of Acquired Capabilities the number(s) have. Supported capabilities are ConferenceAssignment, VoiceApplicationAssignment, UserAssignment, and SharedCalling.
-EndingNumber	String	This is the ending number of a range of Direct Routing telephone number you wish to upload to Microsoft Teams telephone number management inventory.
-FileContent	Byte[]	This is the content of a .csv file that includes the Direct Routing telephone numbers and associated attributes to be uploaded to the Microsoft Teams telephone number management inventory. This parameter can be used...
-LocationId	String	The LocationId of the location to assign to the specific user. You can get it using Get-CsOnlineLisLocation. You can set the location on both assigned and unassigned phone numbers.
-NetworkSiteId	String	ID of a network site. A network site represents a location where your organization has a physical venue, such as offices, a set of buildings, or a campus.
-ReverseNumberLookup	String	This parameter is used to control the behavior of reverse number lookup (RNL) for a phone number. When RNL is set to 'SkipInternalVoip', an internal call to this phone number will not attempt to pass through internal...
-StartingNumber	String	This is the starting number of a range of Direct Routing telephone number you wish to upload to Microsoft Teams telephone number management inventory.
-Tag	String	Indicates the tag to be assigned or created for telephone number(s).
-TelephoneNumber	String	This is the Direct Routing telephone numbers you wish to upload to Microsoft Teams telephone number management inventory. It is comma delimited list of one or more Direct Routing telephone numbers.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.