New-CsPhoneNumberUsageChangeOrder
Creates an order to change the usage type of one or more telephone numbers.
Syntax
Default (Default)
New-CsPhoneNumberUsageChangeOrder
-TelephoneNumber <String[]>
-Usage <String>
[<CommonParameters>]
Description
The New-CsPhoneNumberUsageChangeOrder cmdlet creates a request to update the usage type of the specified telephone numbers.
For example, use -Usage ServiceType to request a change from User Type to Service Type.
The cmdlet returns the order identifier.
Examples
Example 1
New-CsPhoneNumberUsageChangeOrder -TelephoneNumber "+12065550100" -Usage ServiceType
aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
This example creates an order to change the usage of telephone number "+12065550100" to Service Type. The returned string identifies the order.
Example 2
$telephoneNumbers = "+12065550100", "+12065550101"
New-CsPhoneNumberUsageChangeOrder -TelephoneNumber $telephoneNumbers -Usage ServiceType
aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
This example creates one order to change the usage of both telephone numbers to Service Type.
Parameters
-TelephoneNumber
Specifies the telephone numbers whose usage type to change.
Include the country code.
The leading + is optional, for example, "+12065550100" or "12065550100".
To update multiple numbers in one order, pass an array of strings.
Parameter properties
| Type: | System.String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Usage
Specifies the new usage type for the telephone numbers.
For example, specify ServiceType to request Service Type usage.
Parameter properties
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| 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
System.String
The identifier of the phone number usage change order.
Notes
This cmdlet is available in Teams PowerShell module 8.0.0 or later.