New-CsAutoAttendantCallableEntity

The New-CsAutoAttendantCallableEntity cmdlet lets you create a callable entity.

Syntax

New-CsAutoAttendantCallableEntity
   -Identity <String>
   -Type <User | ApplicationEndpoint>
   [-Tenant <Guid>]
   [<CommonParameters>]

Description

The New-CsAutoAttendantCallableEntity cmdlet lets you create a callable entity for use with call transfers from the Auto Attendant service. Callable entities can be created using either Object ID or TEL URIs and can refer to any of the following entities:

  • User
  • ApplicationEndpoint

Examples

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

$callableEntity = New-CsAutoAttendantCallableEntity -Identity "9bad1a25-3203-5207-b34d-1bd933b867a5" -Type User

This example creates a user callable entity.

-------------------------- Example 2 --------------------------

$callableEntity = New-CsAutoAttendantCallableEntity -Identity "tel:+1234567890" -Type ApplicationEndpoint

This example creates an application endpoint callable entity.

-------------------------- Example 3 --------------------------

$operatorObjectId = (Get-CsOnlineUser operator@contoso.com).ObjectId
$callableEntity = New-CsAutoAttendantCallableEntity -Identity $operatorObjectId -Type User

This example gets a user object using Get-CsOnlineUser cmdlet. We then use the AAD ObjectId of that user object to create a user callable entity.

-------------------------- Example 4 --------------------------

$callableEntityId = (Find-CsOnlineApplicationInstance -SearchQuery "Main Auto Attendant") -MaxResults 1 | Select-Object -Property Id
 $callableEntity = New-CsAutoAttendantCallableEntity -Identity $callableEntityId -Type ApplicationEndpoint

This example gets an application instance by name using Find-CsOnlineApplicationInstance cmdlet. We then use the AAD ObjectId of that application instance to create an application endpoint callable entity.

Parameters

-Identity

The Identity parameter represents the ID of the callable entity; this can be either a Object ID or a TEL URI.

  • Only the Object IDs of users that have Enterprise Voice enabled are supported.
  • Only PSTN numbers that are acquired and assigned through Skype for Business Online are supported.
Type:System.String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Tenant
Type:System.Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Type

The Type parameter represents the type of the callable entity, which can be any of the following:

  • User
  • ApplicationEndpoint
Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online

Inputs

None

Outputs

Microsoft.Rtc.Management.Hosted.OAA.Models.CallableEntity