Topic Last Modified: 2017-03-22

Use the Get-CsOnlineVoicemailPolicy cmdlet to get a list of all pre-configured policy instances for Voicemail service.

Get-CsOnlineVoicemailPolicy [-Identity <XdsIdentity>] <COMMON PARAMETERS>

Get-CsOnlineVoicemailPolicy [-Filter <String>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-LocalStore <SwitchParameter>] [-Tenant <Guid>]

In Example 1, the Get-CsOnlineVoicemailPolicy cmdlet is called without any additional parameters; this returns a collection of all the voicemail policies configured for use in your organization.


In Example 2, the Get-CsOnlineVoicemailPolicy cmdlet is used to return the per-user voicemail policy that has an Identity TranscriptionDisabled. Because identities are unique, this command will never return more than one item.

Get-CsOnlineVoicemailPolicy -Identity TranscriptionDisabled

Example 3 uses the Filter parameter to return all the voicemail policies that have been configured at the per-user scope. The filter value "tag:*" tells the Get-CsOnlineVoicemailPolicy cmdlet to return only those policies that have an Identity that begins with the string value "tag:"..

Get-CsOnlineVoicemailPolicy -Filter "tag:*"

This cmdlet retrieves information about all the voicemail policies that have been configured for use in your organization. Voicemail policies are used by the organization to manage Voicemail-related features such as transcription.


Parameter Required Type Description




This parameter accepts a wildcard string and returns all voicemail policies with identities matching that string. For example, a Filter value of Tag:* will return all preconfigured voicemail policy instances (excluding forest default “Global”) available to use by the tenant admins.




A unique identifier specifying the scope, and in some cases the name, of the policy. If this parameter is omitted, all voicemail policies available for use are returned.




Retrieves the voicemail policy from the local replica of the Central Management store, rather than the Central Management store itself.




Globally unique identifier (GUID) of the Skype for Business Online tenant account whose voicemail policy is to be retrieved. For example: -Tenant "38aad667-af54-4397-aaa7-e94c79ec2308" You can return the tenant ID for each of your tenants by running this command:

Get-CsTenant | Select-Object DisplayName, TenantID

This cmdlet returns instances of the Microsoft.Rtc.Management.WritableConfig.Policy.OnlineVoicemail.OnlineVoicemailPolicy object.