New-CsAutoAttendantDialScope
Use New-CsAutoAttendantDialScope cmdlet to create dial-scopes for use with Auto Attendant (AA) service.
Syntax
Default (Default)
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
Applicable: Microsoft Teams
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.
Parameter properties
| Type: | System.Collections.Generic.List |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-GroupScope
Applicable: Microsoft Teams
Indicates that a dial-scope based on groups (distribution lists, security groups) is to be created.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Tenant
Applicable: Microsoft Teams
Parameter properties
| Type: | System.Guid |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.