Search-CsOnlineTelephoneNumberInventory

Reference

Module:: SkypeForBusiness

Applies to:: Skype for Business Online

Use the Search-CsOnlineTelephoneNumberInventory cmdlet to reserve a telephone numbers that are in inventory and available to be acquired.

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

Search-CsOnlineTelephoneNumberInventory
      [-Tenant <Guid>]
      -RegionalGroup <String>
      -CountryOrRegion <String>
      -Area <String>
      -CapitalOrMajorCity <String>
      -Quantity <Int32>
      [-TelephoneNumber <String>]
      [-AreaCode <String>]
      -InventoryType <String>
      [-DomainController <Fqdn>]
      [-Force]
      [<CommonParameters>]

Description

Acquiring tenant telephone numbers is a two step process.

+12127539059 +1 (212) 753 9059

Select-CsOnlineTelephoneNumberInventory -ReservationId 76ce711f-9da4-46d9-b81d-471172450443 -TelephoneNumbers 12127539058,12127539059 -Region NOAM -Country US -Area NY -City NY

Examples

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

Search-CsOnlineTelephoneNumberInventory -InventoryType Service -Region NOAM -Country US -Area NY -City NY -Quantity 10

This example reserves 10 Service type telephone numbers in New York, New York.

Parameters

-Area

Specifies the target geographical area for the cmdlet.

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

-AreaCode

Specifies the area code to search for telephone numbers.

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

-CapitalOrMajorCity

Specifies the target geographical city for the cmdlet.

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

-CountryOrRegion

Specifies the target country for the cmdlet.

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

-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

-Quantity

Specifies the quantity of telephone numbers to reserve. The maximum value is 500.

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

-RegionalGroup

Specifies the target geographical region for the cmdlet.

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

-TelephoneNumber

Specifies either an individual telephone number to reserve, or multiple telephone numbers can be entered separated by a comma.

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

-Tenant

Specifies your tenant identifier. To find your tenant id use the command: Get-CsTenant | fl objectid.

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

Inputs

None

Outputs

This cmdlets returns an Microsoft.Rtc.Management.Hosted.Bvd.Types.NumberReservationResponse object.