New-CsOnlineVoicemailPolicy

Creates a new Online Voicemail policy. Online Voicemail policies determine whether or not voicemail transcription, profanity masking for the voicemail transcriptions, translation for the voicemail transcriptions, and editing call answer rule settings are enabled for a user. The policies also specify voicemail maximum recording length for a user and the primary and secondary voicemail system prompt languages.

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>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cloud Voicemail service provides organizations with voicemail deposit capabilities for Phone System implementation.

By default, users enabled for Phone System will be enabled for Cloud Voicemail. The Online Voicemail policy controls whether or not voicemail transcription, profanity masking for the voicemail transcriptions, translation for the voicemail transcriptions, and editing call answer rule settings are enabled for a user. The policies also specify the voicemail maximum recording length for a user and the primary and secondary voicemail system prompt languages.

  • Voicemail transcription is enabled by default
  • Transcription profanity masking is disabled by default
  • Transcription translation is enabled by default
  • Editing call answer rule settings is enabled by default
  • Voicemail maximum recording length is set to 5 minutes by default
  • Primary and secondary system prompt languages are set to null by default and the user's voicemail language setting is used

Tenant admin would be able to create a customized online voicemail policy to match the organization's requirements.

Examples

-------------------------- Example 1 --------------------------

New-CsOnlineVoicemailPolicy -Identity "CustomOnlineVoicemailPolicy" -MaximumRecordingLength ([TimeSpan]::FromSeconds(60))

The command shown in Example 1 creates a per-user online voicemail policy CustomOnlineVoicemailPolicy with MaximumRecordingLength set to 60 seconds and other fields set to tenant level global value.

Parameters

-Confirm

Prompts you for confirmation before executing the command.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-EnableEditingCallAnswerRulesSetting

Controls if editing call answer rule settings are enabled or disabled for a user. Possible values are $true or $false.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-EnableTranscription

Allows you to disable or enable voicemail transcription. Possible values are $true or $false.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-EnableTranscriptionProfanityMasking

Allows you to disable or enable profanity masking for the voicemail transcriptions. Possible values are $true or $false.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-EnableTranscriptionTranslation

Allows you to disable or enable translation for the voicemail transcriptions. Possible values are $true or $false.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-Identity

A unique identifier specifying the scope, and in some cases the name, of the policy.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-MaximumRecordingLength

A duration of voicemail maximum recording length. The length should be between 30 seconds to 10 minutes.

Type:Duration
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-PostambleAudioFile

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-PreambleAudioFile

The audio file to play to the caller before the user's voicemail greeting is played.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-PreamblePostambleMandatory

Is playing the Pre- or Post-amble mandatory before the caller can leave a message.

Type:Boolean
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-PrimarySystemPromptLanguage

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 Set-CsOnlineVoicemailUserSettings -PromptLanguage for supported languages.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-SecondarySystemPromptLanguage

The secondary language that voicemail system prompts will be presented in. Must also set PrimarySystemPromptLanguage and may not be the same value as PrimarySystemPromptanguage. When set, this overrides the user language choice. Please see Set-CsOnlineVoicemailUserSettings -PromptLanguage for supported languages.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-ShareData

Specifies whether voicemail and transcription data are shared with the service for training and improving accuracy. Possible values are Defer and Deny.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams