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
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>]
[-CallQueueAgentMonitorMode <Disabled | Monitor | Whisper | Barge | Takeover>]
[-CallQueueAgentMonitorNotificationMode <Disabled | Agent>]
[-RealTimeAutoAttendantMetricsPermission <string>]
[-RealTimeCallQueueMetricsPermission <string>]
[-RealTimeAgentMetricsPermission <string>]
[-HistoricalAutoAttendantMetricsPermission <string>]
[-HistoricalCallQueueMetricsPermission <string>]
[-HistoricalAgentMetricsPermission <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 $trueThe 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 $trueThe 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowAutoAttendantLanguageChange
This option is not currently available in Queues app.
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowAutoAttendantTimeZoneChange
This option is not currently available in Queues app.
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowCallQueueLanguageChange
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 language. When set to False (the default value), users affected by the policy won't be allowed to change the call queue's language.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CallQueueAgentMonitorMode
This option is not currently available in Queues app.
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.
| Type: | Object |
| Position: | Named |
| Default value: | Disabled |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Microsoft Teams |
-CallQueueAgentMonitorNotificationMode
This option is not currently available in Queues app.
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.
| Type: | Object |
| Position: | Named |
| Default value: | Disabled |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Microsoft Teams |
-Confirm
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HistoricalAgentMetricsPermission
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.
| Type: | Object |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Microsoft Teams |
-HistoricalAutoAttendantMetricsPermission
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.
| Type: | Object |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Microsoft Teams |
-HistoricalCallQueueMetricsPermission
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.
| Type: | Object |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Microsoft Teams |
-Identity
Unique identifier assigned to the policy when it was created.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RealTimeAgentMetricsPermission
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.
| Type: | Object |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Microsoft Teams |
-RealTimeAutoAttendantMetricsPermission
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.
| Type: | Object |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Microsoft Teams |
-RealTimeCallQueueMetricsPermission
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.
| Type: | Object |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Microsoft Teams |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Outputs
System.Object