Modifier

Partager via

New-CsAutoAttendantDialScope

  • Reference
Module:
MicrosoftTeamsPowerShell
Applies to:
Microsoft Teams

Use New-CsAutoAttendantDialScope cmdlet to create dial-scopes for use with Auto Attendant (AA) service.

Syntax

New-CsAutoAttendantDialScope
   -GroupScope
   -GroupIds <List>
   [-Tenant <Guid>]
   [<CommonParameters>]

Description

This cmdlet creates a new dial-scope to be used with Auto Attendant (AA) service. AAs use dial-scopes to restrict the scope of call transfers that can be made through directory lookup feature.

NOTE: The returned dial-scope model composes a member for the underlying type/implementation, e.g. in case of the group-based dial scope, in order to modify its Group IDs, you can access them through DialScope.GroupScope.GroupIds.

Examples

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

$groupIds = @("00000000-0000-0000-0000-000000000000")
$dialScope = New-CsAutoAttendantDialScope -GroupScope -GroupIds $groupIds

In Example 1, the New-CsAutoAttendantDialScope cmdlet is used to create a dial-scope with a group whose id is 00000000-0000-0000-0000-000000000000.

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

$groupIds = Find-CsGroup -SearchQuery "Contoso Sales" | % { $_.Id }
$dialScope = New-CsAutoAttendantDialScope -GroupScope -GroupIds $groupIds

In Example 2, we use the Find-CsGroup cmdlet to find groups with name "Contoso Sales", and then use the identities of those groups to create an auto attendant dial scope using the New-CsAutoAttendantDialScope cmdlet.

Parameters

-GroupIds

Refers to the IDs of the groups that are to be included in the dial-scope.

Group IDs can be obtained by using the Find-CsGroup cmdlet.

Type:System.Collections.Generic.List
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-GroupScope

Indicates that a dial-scope based on groups (distribution lists, security groups) is to be created.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-Tenant

Type:System.Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

Inputs

None

Outputs

Microsoft.Rtc.Management.OAA.Models.DialScope