Commands › Microsoft Teams
New-CsOnlineVoicemailPolicy
Creates a new Online Voicemail policy.
Quick start script
# New-CsOnlineVoicemailPolicy — 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-CsOnlineVoicemailPolicy
$before | Format-List
# 3. Make the change (dry run first)
New-CsOnlineVoicemailPolicy -WhatIf
New-CsOnlineVoicemailPolicy
# 4. Verify and diff
$after = Get-CsOnlineVoicemailPolicy
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
New-CsOnlineVoicemailPolicy [-Identity] <string> [-EnableEditingCallAnswerRulesSetting <boolean>]
[-EnableTranscription <boolean>] [-EnableTranscriptionProfanityMasking <boolean>]
[-EnableTranscriptionTranslation <boolean>] [-MaximumRecordingLength <timespan>]
[-PostAmbleAudioFile <string>] [-PreambleAudioFile <string>]
[-PreamblePostambleMandatory <boolean>] [-PrimarySystemPromptLanguage <string>]
[-SecondarySystemPromptLanguage <string>] [-ShareData <string>] [-EnableVoicemailTriage <boolean>] [-WhatIf] [-Confirm]
[-Description <String>] [<CommonParameters>]Parameters (16)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Confirm | SwitchParameter | Prompts you for confirmation before executing the command. | |
| -Description | String | Enables administrators to provide explanatory text about the policy. For example, the Description might indicate the users the policy should be assigned to. | |
| -EnableEditingCallAnswerRulesSetting | Boolean | Controls if editing call answer rule settings are enabled or disabled for a user. Possible values are $true or $false. | |
| -EnableTranscription | Boolean | Allows you to disable or enable voicemail transcription. Possible values are $true or $false. | |
| -EnableTranscriptionProfanityMasking | Boolean | Allows you to disable or enable profanity masking for the voicemail transcriptions. Possible values are $true or $false. | |
| -EnableTranscriptionTranslation | Boolean | Allows you to disable or enable translation for the voicemail transcriptions. Possible values are $true or $false. | |
| -EnableVoicemailTriage | Boolean | Specifies whether AI-powered voicemail triage is enabled. | |
| -Identity | String | A unique identifier specifying the scope, and in some cases the name, of the policy. | |
| -MaximumRecordingLength | TimeSpan | A duration of voicemail maximum recording length. The length should be between 30 seconds to 10 minutes. | |
| -PostambleAudioFile | String | The audio file to play to the caller after the user's voicemail greeting has played and before the caller is allowed to leave a voicemail message. | |
| -PreambleAudioFile | String | The audio file to play to the caller before the user's voicemail greeting is played. | |
| -PreamblePostambleMandatory | Boolean | Is playing the Pre- or Post-amble mandatory before the caller can leave a message. | |
| -PrimarySystemPromptLanguage | String | The primary (or first) language that voicemail system prompts will be presented in. Must also set SecondarySystemPromptLanguage. When set, this overrides the user language choice. Please see... | |
| -SecondarySystemPromptLanguage | String | The secondary language that voicemail system prompts will be presented in. Must also set PrimarySystemPromptLanguage and may not be the same value as PrimarySystemPromptLanguage. When set, this overrides the user... | |
| -ShareData | String | Specifies whether voicemail and transcription data are shared with the service for training and improving accuracy. Possible values are Defer and Deny. | |
| -WhatIf | SwitchParameter | Describes what would happen if you executed the command without actually executing the command. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.