[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Retrieves a hosted voice mail policy.


Get-CsHostedVoicemailPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsHostedVoicemailPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]


Parameter Required Type Description




The unique identifier for the hosted voice mail policy you want to retrieve. The Identity includes the scope (in the case of global), the scope and site (for a site policy, such as site:Redmond), or the policy name (for a per-user policy, such as HVUserPolicy).




This parameter allows you to do a wildcard search on the Identity of the hosted voice mail policy. This will retrieve all instances of a hosted voice mail policy where the Identity matches the wildcard pattern specified in the Filter value.




Retrieves the hosted voice mail policy from the local replica of the Central Management database, rather than the Central Management database itself.

Detailed Description

This cmdlet retrieves a policy that specifies how to route unanswered calls to a user to a hosted Exchange Unified Messaging (UM) service.

A user must be enabled for Exchange UM hosted voice mail for this policy to take effect. You can call the Get-CsUser cmdlet and check the HostedVoiceMail property to determine whether a user is enabled for hosted voice mail. (A value of True means the user is enabled.)

Return Types

This cmdlet returns an object of type Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy


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

Copy Code

This command returns all defined hosted voice mail policies for the Microsoft Communications Server 2010 organization.

-------------------------- Example 2 --------------------------

Copy Code
Get-CsHostedVoicemailPolicy -Identity ExRedmond

This command returns the policy settings for the per-user hosted voice mail policy ExRedmond.

-------------------------- Example 3 --------------------------

Copy Code
Get-CsHostedVoicemailPolicy -Filter tag:*

This command returns the policy settings for all per-user hosted voice mail policies (policies beginning with the tag scope).