Commands › Microsoft Teams
Set-CsTeamsVoiceApplicationsPolicy
Modifies an existing Teams voice applications policy.
Quick start script
# Set-CsTeamsVoiceApplicationsPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId
# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsTeamsVoiceApplicationsPolicy
$before | Format-List
# 3. Make the change (dry run first)
Set-CsTeamsVoiceApplicationsPolicy -WhatIf
Set-CsTeamsVoiceApplicationsPolicy
# 4. Verify and diff
$after = Get-CsTeamsVoiceApplicationsPolicy
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
Set-CsTeamsVoiceApplicationsPolicy
[-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 <Boolean>]
[-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>]
[[-Identity] <String>]
[-WhatIf] [-Confirm] [<CommonParameters>]Parameters (36)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -AllowAutoAttendantAfterHoursGreetingChange | Boolean | 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... | |
| -AllowAutoAttendantAfterHoursRoutingChange | Boolean | 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... | |
| -AllowAutoAttendantBusinessHoursChange | Boolean | 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... | |
| -AllowAutoAttendantBusinessHoursGreetingChange | Boolean | 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... | |
| -AllowAutoAttendantBusinessHoursRoutingChange | Boolean | 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... | |
| -AllowAutoAttendantHolidayGreetingChange | Boolean | 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... | |
| -AllowAutoAttendantHolidayRoutingChange | Boolean | 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... | |
| -AllowAutoAttendantHolidaysChange | Boolean | 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... | |
| -AllowAutoAttendantLanguageChange | Boolean | _This feature is not currently available to authorized users._ | |
| -AllowAutoAttendantTimeZoneChange | Boolean | _This feature is not currently available to authorized users._ | |
| -AllowCallQueueAgentOptChange | Boolean | 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... | |
| -AllowCallQueueConferenceModeChange | Boolean | 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... | |
| -AllowCallQueueLanguageChange | Boolean | _This feature is not currently available to authorized users._ | |
| -AllowCallQueueMembershipChange | Boolean | 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. | |
| -AllowCallQueueMusicOnHoldChange | Boolean | 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... | |
| -AllowCallQueueNoAgentSharedVoicemailGreetingChange | Boolean | _This feature is not currently available to authorized users._ | |
| -AllowCallQueueNoAgentsRoutingChange | Boolean | 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... | |
| -AllowCallQueueOptOutChange | Boolean | 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... | |
| -AllowCallQueueOverflowRoutingChange | Boolean | 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... | |
| -AllowCallQueueOverflowSharedVoicemailGreetingChange | Boolean | 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... | |
| -AllowCallQueuePresenceBasedRoutingChange | Boolean | 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... | |
| -AllowCallQueueRoutingMethodChange | Boolean | 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... | |
| -AllowCallQueueTimeoutRoutingChange | Boolean | 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... | |
| -AllowCallQueueTimeoutSharedVoicemailGreetingChange | Boolean | 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... | |
| -AllowCallQueueWelcomeGreetingChange | Boolean | 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... | |
| -CallQueueAgentMonitorMode | Object | Supported values: Disabled | Monitor | Whisper | Barge | Takeover | |
| -CallQueueAgentMonitorNotificationMode | Object | Supported values: Disabled | Agent | |
| -Confirm | SwitchParameter | Prompts you for confirmation before running the cmdlet. | |
| -HistoricalAgentMetricsPermission | Object | Supported values: Disabled | AuthorizedOnly | All | |
| -HistoricalAutoAttendantMetricsPermission | Object | Supported values: Disabled | AuthorizedOnly | All | |
| -HistoricalCallQueueMetricsPermission | Object | Supported values: Disabled | AuthorizedOnly | All | |
| -Identity | String | Unique identifier assigned to the policy when it was created. Teams voice applications policies can be assigned at the global scope or the per-user scope. To refer to the global instance, use this syntax: | |
| -RealTimeAgentMetricsPermission | Object | Supported values: Disabled | AuthorizedOnly | All | |
| -RealTimeAutoAttendantMetricsPermission | Object | Supported values: Disabled | AuthorizedOnly | All | |
| -RealTimeCallQueueMetricsPermission | Object | Supported values: Disabled | AuthorizedOnly | All | |
| -WhatIf | SwitchParameter | Shows what would happen if the cmdlet runs. The cmdlet is not run. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.