Edit

New-CsPhoneNumberBulkUpdateLocationIdOrder

Module:
MicrosoftTeams PowerShell module

This cmdlet allows the admin to update LocationId for one or multiple telephone numbers at once.

Syntax

Default (Default) 

New-CsPhoneNumberBulkUpdateLocationIdOrder
    [-LocationId <String>]
    [-PhoneNumbers <String>]
    [<CommonParameters>]

Description

This cmdlet lets the admin update the LocationId for multiple phone numbers at once. There can be maximum of 1000 phone numbers updated in a single command.

Examples

Example 1

PS C:\> New-CsPhoneNumberBulkUpdateLocationIdOrder -PhoneNumbers "12056788888,12056789999" -LocationId "f84h3gs5-2a32-s5fd-1233-32sf84h3gs54"

Id                                    OrderType
--                                    ---------
0a000a0a-aa0a-0a0a-aa0a-a0aa0aa       NumberUpdate

This example shows how to update LocationId for two numbers.

Example 2

PS C:\> New-CsPhoneNumberBulkUpdateLocationIdOrder -PhoneNumbers "12056788888,12056789999" -LocationId "null"

Id                                    OrderType
--                                    ---------
0a000a0a-aa0a-0a0a-aa0a-a0aa0aa       NumberUpdate

This example shows how to remove LocationId for two numbers. Setting the LocationId to "null" will remove current LocationId for the number.

Parameters

-LocationId

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.

Removal of location from a phone number is supported for Direct Routing numbers and Operator Connect numbers that are not managed by the Service Desk. If you want to remove the location, use the string value null for LocationId.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NewExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PhoneNumbers

The phone numbers to update LocationId for.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NewExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

OrderId

Contains the OrderId for the operation. This will be needed to lookup order status using Get-CsOnlineTelephoneNumberOrder.

OrderType

Type of order submitted. This will be needed to lookup order status using Get-CsOnlineTelephoneNumberOrder.