Clear-CsOnlineTelephoneNumberReservation

Reference

Module:: SkypeForBusiness

Applies to:: Skype for Business Online

Use the Clear-CsOnlineTelephoneNumberReservation cmdlet to clear a reserved list of telephone numbers before they are acquired. The telephone numbers will then be available for search and reservation again.

Note:

As of April 30, 2022, the existing Skype for Business PowerShell cmdlets for telephone number search and related activities will be deprecated and will no longer be available for use. The new Teams PowerShell cmdlets for telephone number search and related activities are already available. For more details, see New-CsOnlineTelephoneNumberOrder.

Syntax

Clear-CsOnlineTelephoneNumberReservation
     [-Tenant <Guid>]
     -ReservationId <String>
     -InventoryType <String>
     [-DomainController <Fqdn>]
     [-Force]
     [<CommonParameters>]

Description

This cmdlet will fail if any of the numbers in the reservation have already been assigned. An error message will identify the source of the failure.

Examples

-------------------------- Example 1 --------------------------

Clear-CsOnlineTelephoneNumberReservation -ReservationId b1ae43f5-07ab-4b81-be32-4b8cc2d11f75 -InventoryType Service

This example clears a reservation with an inventory type of "Service".

Parameters

-DomainController

This parameter is reserved for internal Microsoft use.

Type:	Fqdn
Aliases:	DC
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Skype for Business Online

-Force

The Force switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If the Force switch isn't provided in the command, you're prompted for administrative input if required.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Skype for Business Online

-InventoryType

Specifies the target telephone number type for the cmdlet. Acceptable values are:

"Service" for numbers assigned to conferencing support.
"Subscriber" for numbers supporting public switched telephone network (PSTN) functions.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Skype for Business Online

-ReservationId

Specifies the identification of the reservation you want to clear.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Skype for Business Online

-Tenant