Edit

Share via

Export-CsAcquiredPhoneNumber

  • Reference
Module:
MicrosoftTeamsPowerShell
Applies to:
Microsoft Teams

This cmdlet exports the list of phone numbers acquired by Teams Phone tenant.

Syntax

Export-CsAcquiredPhoneNumber
      [-Property <String>]
      [<CommonParameters>]

Description

This cmdlet exports all the acquired phone numbers by the tenant to a file. The cmdlet is an asynchronus operation and will return an OrderId. Get-CsExportAcquiredPhoneNumberStatus cmdlet can be used to check the status of the OrderId including the download link to exported file.

By default, this cmdlet returns all the phone numbers acquired by the tenant with all corresponding properties in the results. The tenant admin may indicate specific properties as an input to get a list with only selected properties in the file.

Available properties to use are:

  • TelephoneNumber
  • OperatorId
  • NumberType
  • LocationId
  • CivicAddressId
  • NetworkSiteId
  • AvailableCapabilities
  • AcquiredCapabilities
  • AssignmentStatus
  • PlaceName
  • ActivationState
  • PartnerName
  • IsoCountryCode
  • PortInOrderStatus
  • CapabilityUpdateSupported
  • AcquisitionDate
  • TargetId
  • TargetType
  • AssignmentCategory
  • CallingProfileId
  • IsoSubdivisionCode
  • NumberSource
  • SupportedCustomerActions
  • ReverseNumberLookup
  • RoutingOptions

Examples

Example 1

PS C:\> Export-CsAcquiredPhoneNumber

0e923e2c-ab0e-4b7a-be5a-906be8c

This example displays the output of the export acquired phone numbers operation. The OrderId shown as the output string and can be used to get the download link for the file.

Example 2

PS C:\> Export-CsAcquiredPhoneNumber -Property "TelephoneNumber, NumberType, AssignmentStatus"

0e923e2c-ab0e-6h8c-be5a-906be8c

This example displays the output of the export acquired phone numbers operation with filtered properties. This file will only contain the properties indicated.

Example 3

PS C:\> $orderId = Export-CsAcquiredPhoneNumber

This example displays the use of variable "orderId" for the export acquired phone numbers operation. The OrderId string will be stored in the variable named "orderId" and no output will be shown for the cmdlet.

Example 4

PS C:\> Export-CsAcquiredPhoneNumber -Property "TelephoneNumber, NumberType, AssignmentStatus"

OrderId         : 0e923e2c-ab0e-6h8c-be5a-906be8c

This example displays the use of variable "orderId" for the export acquired phone numbers operation with filtered properties. The OrderId string will be stored in the variable named "orderId" and no output will be shown for the cmdlet.

Parameters

-Property

{{ Fill Property Description }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

System.String

Notes

The cmdlet is available in Teams PowerShell module 6.1.0 or later.

The cmdlet is only available in commercial and GCC cloud instances.