New-CsAutoAttendantDialScope
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