New-CsTeamsVoiceApplicationsPolicy
Creates a new Teams voice applications policy. TeamsVoiceApplications policy governs what permissions the supervisors/users have over auto attendants and call queues.
Syntax
Default (Default)
New-CsTeamsVoiceApplicationsPolicy
[-Identity] <String>
[-AllowAutoAttendantBusinessHoursGreetingChange <Boolean>]
[-AllowAutoAttendantAfterHoursGreetingChange <Boolean>]
[-AllowAutoAttendantHolidayGreetingChange <Boolean>]
[-AllowAutoAttendantBusinessHoursChange <Boolean>]
[-AllowAutoAttendantHolidaysChange <Boolean>]
[-AllowAutoAttendantTimeZoneChange <Boolean>]
[-AllowAutoAttendantLanguageChange <Boolean>]
[-AllowAutoAttendantBusinessHoursRoutingChange <Boolean>]
[-AllowAutoAttendantAfterHoursRoutingChange <Boolean>]
[-AllowAutoAttendantHolidayRoutingChange <Boolean>]
[-AllowCallQueueWelcomeGreetingChange <Boolean>]
[-AllowCallQueueMusicOnHoldChange <Boolean>]
[-AllowCallQueueOverflowSharedVoicemailGreetingChange <Boolean>]
[-AllowCallQueueTimeoutSharedVoicemailGreetingChange <Boolean>]
[-AllowCallQueueNoAgentSharedVoicemailGreetingChange <bool>]
[-AllowCallQueueLanguageChange <Boolean>]
[-AllowCallQueueMembershipChange <Boolean>]
[-AllowCallQueueConferenceModeChange <Boolean>]
[-AllowCallQueueRoutingMethodChange <Boolean>]
[-AllowCallQueuePresenceBasedRoutingChange <Boolean>]
[-AllowCallQueueOptOutChange <Boolean>]
[-AllowCallQueueOverflowRoutingChange <Boolean>]
[-AllowCallQueueTimeoutRoutingChange <Boolean>]
[-AllowCallQueueNoAgentsRoutingChange <Boolean>]
[-AllowCallQueueAgentOptChange <Boolean>]
[-RealTimeAutoAttendantMetricsPermission <string>]
[-RealTimeCallQueueMetricsPermission <string>]
[-RealTimeAgentMetricsPermission <string>]
[-HistoricalAutoAttendantMetricsPermission <string>]
[-HistoricalCallQueueMetricsPermission <string>]
[-HistoricalAgentMetricsPermission <string>]
[-Description <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
TeamsVoiceApplicationsPolicy is used for Supervisor Delegated Administration which allows admins in the organization to permit certain users to make changes to auto attendant and call queue configurations.
Examples
EXAMPLE 1
New-CsTeamsVoiceApplicationsPolicy -Identity SDA-Allow-CQ-Moh -AllowCallQueueMusicOnHoldChange $true
The command shown in Example 1 creates a new per-user Teams voice applications policy with the Identity SDA-Allow-Moh. This policy allows delegated administrators to change the music on hold information.
EXAMPLE 2
New-CsTeamsVoiceApplicationsPolicy -Identity SDA-Allow-AA-After-Hour -AllowAutoAttendantAfterHoursGreetingChange $true
The command shown in Example 2 creates a new per-user Teams voice applications policy with the Identity SDA-Allow-AA-After-Hour. This policy allows delegated administrators to change after-hours greetings for auto attendants.
Parameters
-AllowAutoAttendantAfterHoursGreetingChange
When set to True, users affected by the policy will be allowed to change the auto attendant's after-hours greeting. When set to False (the default value), users affected by the policy won't be allowed to change the auto attendant's after-hours greeting.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowAutoAttendantAfterHoursRoutingChange
When set to True, users affected by the policy will be allowed to change the auto attendant's after-hours call flow. When set to False (the default value), users affected by the policy won't be allowed to change the auto attendant's after-hours call flow.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowAutoAttendantBusinessHoursChange
When set to True, users affected by the policy will be allowed to change the auto attendant's business hours schedule. When set to False (the default value), users affected by the policy won't be allowed to change the auto attendant's business hours schedule.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowAutoAttendantBusinessHoursGreetingChange
When set to True, users affected by the policy will be allowed to change the auto attendant's business hours greeting. When set to False (the default value), users affected by the policy won't be allowed to change the auto attendant's business hours greeting.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowAutoAttendantBusinessHoursRoutingChange
When set to True, users affected by the policy will be allowed to change the auto attendant's business hours call flow. When set to False (the default value), users affected by the policy won't be allowed to change the auto attendant's business hours call flow.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowAutoAttendantHolidayGreetingChange
When set to True, users affected by the policy will be allowed to change the auto attendant's holiday greeting. When set to False (the default value), users affected by the policy won't be allowed to change the auto attendant's holiday greeting.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowAutoAttendantHolidayRoutingChange
When set to True, users affected by the policy will be allowed to change the auto attendant's holiday call flows. When set to False (the default value), users affected by the policy won't be allowed to change the auto attendant's holiday call flows.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowAutoAttendantHolidaysChange
When set to True, users affected by the policy will be allowed to change the auto attendant's holiday schedules. When set to False (the default value), users affected by the policy won't be allowed to change the auto attendant's holiday schedules.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowAutoAttendantLanguageChange
This feature is not currently available to authorized users.
When set to True, users affected by the policy will be allowed to change the auto attendant's language. When set to False (the default value), users affected by the policy won't be allowed to change the auto attendant's language.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowAutoAttendantTimeZoneChange
This feature is not currently available to authorized users.
When set to True, users affected by the policy will be allowed to change the auto attendant's time zone. When set to False (the default value), users affected by the policy won't be allowed to change the auto attendant's time zone.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueueAgentOptChange
When set to True, users affected by the policy will be allowed to change an agent's opt-in status in the call queue. When set to False (the default value), users affected by the policy won't be allowed to change an agent's opt-in status in the call queue.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueueConferenceModeChange
When set to True, users affected by the policy will be allowed to change the call queue's conference mode. When set to False (the default value), users affected by the policy won't be allowed to change the call queue's conference mode.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueueLanguageChange
This feature is not currently available to authorized users.
When set to True, users affected by the policy will be allowed to change the call queue's language. When set to False (the default value), users affected by the policy won't be allowed to change the call queue's language.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueueMembershipChange
When set to True, users affected by the policy will be allowed to change the call queue's users. When set to False (the default value), users affected by the policy won't be allowed to change the call queue's users.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueueMusicOnHoldChange
When set to True, users affected by the policy will be allowed to change the call queue's music on hold information. When set to False (the default value), users affected by the policy won't be allowed to change the call queue's music on hold.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueueNoAgentSharedVoicemailGreetingChange
This option is not currently available in Queues app.
When set to True, users affected by the policy will be allowed to change the call queue's no agent shared voicemail greeting. When set to False (the default value), users affected by the policy won't be allowed to change the call queue's no agent shared voicemail greeting.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueueNoAgentsRoutingChange
When set to True, users affected by the policy will be allowed to change the call queue's no-agent handling properties. When set to False (the default value), users affected by the policy won't be allowed to change the call queue's no-agent handling properties.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueueOptOutChange
When set to True, users affected by the policy will be allowed to change the call queue opt-out setting that allows agents to opt out of receiving calls. When set to False (the default value), users affected by the policy won't be allowed to change the call queue opt-out setting.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueueOverflowRoutingChange
When set to True, users affected by the policy will be allowed to change the call queue's overflow handling properties. When set to False (the default value), users affected by the policy won't be allowed to change the call queue's overflow handling properties.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueueOverflowSharedVoicemailGreetingChange
When set to True, users affected by the policy will be allowed to change the call queue's overflow shared voicemail greeting. When set to False (the default value), users affected by the policy won't be allowed to change the call queue's overflow shared voicemail greeting.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueuePresenceBasedRoutingChange
When set to True, users affected by the policy will be allowed to change the call queue's presence-based routing option. When set to False (the default value), users affected by the policy won't be allowed to change the call queue's presence-based routing option.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueueRoutingMethodChange
When set to True, users affected by the policy will be allowed to change the call queue's routing method. When set to False (the default value), users affected by the policy won't be allowed to change the call queue's routing method.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueueTimeoutRoutingChange
When set to True, users affected by the policy will be allowed to change the call queue's timeout handling properties. When set to False (the default value), users affected by the policy won't be allowed to change the call queue's timeout handling properties.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueueTimeoutSharedVoicemailGreetingChange
When set to True, users affected by the policy will be allowed to change the call queue's timeout shared voicemail greeting. When set to False (the default value), users affected by the policy won't be allowed to change the call queue's timeout shared voicemail greeting.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-AllowCallQueueWelcomeGreetingChange
When set to True, users affected by the policy will be allowed to change the call queue's welcome greeting. When set to False (the default value), users affected by the policy won't be allowed to change the call queue's welcome greeting.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| 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 |
-CallQueueAgentMonitorMode
Applicable: Microsoft Teams
PARAMVALUE: Disabled | Monitor | Whisper | Barge | Takeover
When set to Disabled (the default value), users affected by the policy won't be allowed to monitor call sessions.
When set to Monitor, users affected by the policy will be allowed to monitor and listen to call sessions.
When set to Whisper, users affected by the policy will be allowed to monitor call sessions and whisper to an agent in the call.
When set to Barge, users affected by the policy will be allowed to monitor call sessions, whisper to an agent in the call, or join the call session.
When set to Takeover, users affected by the policy will be allowed to monitor call sessions, whisper to an agent in the call, join the call session, or take over the call from an agent.
Parameter properties
| Type: | Object |
| Default value: | Disabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Dual
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-CallQueueAgentMonitorNotificationMode
Applicable: Microsoft Teams
PARAMVALUE: Disabled | Agent
When set to Disabled (the default value), users affected by the policy won't be allowed to monitor agents during call sessions.
When set to Agent, users affected by the policy will be allowed to monitor agents during call sessions.
Parameter properties
| Type: | Object |
| Default value: | Disabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Dual
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Description
Enables administrators to provide explanatory text about the policy. For example, the Description might indicate the users the policy should be assigned to.
Parameter properties
| Type: | String |
| 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 |
-HistoricalAgentMetricsPermission
Applicable: Microsoft Teams
PARAMVALUE: Disabled | AuthorizedOnly | All
When set to Disabled (the default value), users affected by the policy won't receive historical metrics for agents.
When set to AuthorizedOnly, users affected by the policy will receive historical metrics for agents who are members in the call queues they are authorized for.
When set to All, users affected by the policy will receive historical metrics for all agents in all call queues in the organization.
Parameter properties
| Type: | Object |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Dual
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-HistoricalAutoAttendantMetricsPermission
Applicable: Microsoft Teams
PARAMVALUE: Disabled | AuthorizedOnly | All
When set to Disabled (the default value), users affected by the policy won't receive historical metrics for auto attendants.
When set to AuthorizedOnly, users affected by the policy will receive historical metrics for auto attendants they are authorized for.
When set to All, users affected by the policy will receive historical metrics for all auto attendants in the organization.
Parameter properties
| Type: | Object |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Dual
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-HistoricalCallQueueMetricsPermission
Applicable: Microsoft Teams
PARAMVALUE: Disabled | AuthorizedOnly | All
When set to Disabled (the default value), users affected by the policy won't receive historical metrics for call queues.
When set to AuthorizedOnly, users affected by the policy will receive historical metrics for call queues they are authorized for.
When set to All, users affected by the policy will receive historical metrics for all call queues in the organization.
Parameter properties
| Type: | Object |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Dual
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Identity
Unique identifier assigned to the policy when it was created.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-RealTimeAgentMetricsPermission
Applicable: Microsoft Teams
PARAMVALUE: Disabled | AuthorizedOnly | All
When set to Disabled (the default value), users affected by the policy won't receive real-time metrics for agents.
When set to AuthorizedOnly, users affected by the policy will receive real-time metrics for agents who are members in the call queues they are authorized for.
Important
The All option is no longer supported. The parameter will be accepted and saved, however, any user assigned a policy with RealTimeAgentMetricsPermission set to All won't be able to access real-time metrics.
Parameter properties
| Type: | Object |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Dual
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-RealTimeAutoAttendantMetricsPermission
Applicable: Microsoft Teams
PARAMVALUE: Disabled | AuthorizedOnly | All
When set to Disabled (the default value), users affected by the policy won't receive real-time metrics for auto attendants.
When set to AuthorizedOnly, users affected by the policy will receive real-time metrics for auto attendants they are authorized for.
Important
The All option is no longer supported. The parameter will be accepted and saved, however, any user assigned a policy with RealTimeAutoAttendantMetricsPermission set to All won't be able to access real-time metrics.
Parameter properties
| Type: | Object |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Dual
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-RealTimeCallQueueMetricsPermission
Applicable: Microsoft Teams
PARAMVALUE: Disabled | AuthorizedOnly | All
When set to Disabled (the default value), users affected by the policy won't receive real-time metrics for call queues.
When set to AuthorizedOnly, users affected by the policy will receive real-time metrics for call queues they are authorized for.
Important
The All option is no longer supported. The parameter will be accepted and saved, however, any user assigned a policy with RealTimeCallQueueMetricsPermission set to All won't be able to access real-time metrics.
Parameter properties
| Type: | Object |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Dual
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
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.