Copy-UMCustomPrompt (RTM)

Article
01/23/2017

Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.

Applies to: Exchange Server 2007

The Copy-UMCustomPrompt cmdlet validates and then copies a .wav audio file from a specified location to the UM prompt publishing point on a computer that is running Microsoft Exchange Server 2007 that has the Unified Messaging (UM) server role installed. You can also use this cmdlet to copy a .wav audio file from the UM prompt publishing point to a file.

Syntax

Copy-UMCustomPrompt -Path <String> -UMDialPlan <UMDialPlanIdParameter> [-DomainController <Fqdn>]

Copy-UMCustomPrompt -Path <String> -UMAutoAttendant <UMAutoAttendantIdParameter> [-DomainController <Fqdn>]

Copy-UMCustomPrompt -UMDialPlan <UMDialPlanIdParameter> [-DomainController <Fqdn>]

Copy-UMCustomPrompt -UMAutoAttendant <UMAutoAttendantIdParameter> [-DomainController <Fqdn>]

Detailed Description

The Copy-UMCustomPrompt cmdlet is used to validate and then copy a .wav audio file to the UM prompt publishing point. The UM prompt publishing point is a shared folder that is created on the first Unified Messaging server that is installed and is used to distribute UM custom prompts to other Unified Messaging servers in the Exchange 2007 organization. The Copy-UMCustomPrompt cmdlet supports the use of UM custom audio prompts by copying the specified audio file to the correct location for distribution to other Unified Messaging servers in the Exchange 2007 organization.

Unified Messaging servers access the UM prompt publishing point at set intervals and copy the necessary .wav audio files to their local installation folder. After the file has been copied locally to the Unified Messaging server, the Unified Messaging server can provide the audio for a given custom prompt when it is required by the telephone user interface (TUI).

To run the Copy-UMCustomPrompt cmdlet, the account you use must be delegated the following:

Exchange Organization Administrator role

For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.

Parameters

Parameter	Required	Type	Description
Path	Required	System.String	This parameter specifies the full path and name of the source file. The source file is the file that will be copied to the UM prompt publishing point.
UMAutoAttendant	Required	Microsoft.Exchange.Configuration.Tasks.UMAutoAttendantIdParameter	This parameter specifies the identifier for the UM auto attendant. This identifier is the directory object ID for the UM auto attendant.
UMDialPlan	Required	Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter	This parameter specifies the identifier for the UM dial plan. This identifier is the directory object ID for the UM dial plan. This parameter is not required if the UMAutoAttendant parameter is used.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	This parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory, include the DomainController parameter on the command.

Input Types

Return Types

Errors

Error	Description

Exceptions

Exceptions	Description

Example

The first example copies the prompt file that is named Main Welcome.wav into the directory C:\Prompts so that it can be used as a set of custom prompts for the UM dial plan named Contoso. The prompt that is copied replaces the default welcome greeting for the dial plan. Therefore, the Copy-UMCustomPrompt cmdlet should be followed by the Set-UMDialPlan cmdlet. This sets the WelcomeGreetingFilename property to the value Campus Main Welcome.wav.

The second example copies the prompt file that is named Tech Support Menu.wav in the current working directory into the set of custom prompts for the auto attendant that is named Technical Support. The prompt that is copied replaces the custom menu prompt that is used during business hours. Therefore, the Copy-UMCustomPrompt cmdlet should be followed by the Set-UMAutoAttendant cmdlet. This sets the BusinessHoursMainMenuFilename property to the value Tech Support Menu.wav.

Copy-UMCustomPrompt -Path "C:\Prompts\Main Welcome.wav" -UMDialPlan Contoso

Copy-UMCustomPrompt -Path "Tech Support Menu.wav" -UMAutoAttendant "Technical Support"

Share via