Unified Messaging 2007 Provider::NewUMDialPlan

  • Article

This procedure creates a new Unified Messaging (UM) Dial Plan.

Arguments

Input Arguments Required Description

<preferredDomainController>

Yes

The domain controller to use for Active Directory actions.

<name>

Yes

The name for the new IP Gateway.

<numberOfDigitsInExtension>

Yes

This parameter specifies the number of digits that will be in an extension, range 3 to 7.

<accessTelephoneNumbers>

No

The parent container for accessTelephoneNumber node list.

<accessTelephoneNumber>

No

One or more of these define the list of access or pilot phone numbers. Range 1 to 32 characters.

<faxEnabled>

No

This parameter allows users to receive faxes. Default true.

<generateUMMailboxPolicy>

No

This parameter specifies whether a default UM mailbox policy will be created when the UM dial plan is created. The default setting is to create a UM mailbox when the UM dial plan is created.

<ndrEnabled>

No

This parameter specifies whether UM call answering messages that are submitted will request non-delivery notifications. The default setting is $false.

<templateInstance>

No

When an existing object is supplied to this parameter, the cmdlet will use the configuration of that object to create an identical copy of the object on a local or target server.

<uriType>

No

This parameter specifies the integer that represents the Uniform Resource Identifier (URI) type to be sent and received with Session Initiation Protocol (SIP) messages from the Private Branch eXchange (PBX).

<voIPSecurity>

No

This parameter specifies whether the signaling channel, signaling and media channels, or neither channel will be secured. The default setting is Secured.

Remarks

Security

The caller must be at least a member of role: UserCreators.

Sample Code

Example XML Request

<request> 
        <data/> 
        <procedure> 
                <execute namespace='Unified Messaging 2007 Provider' procedure='NewUMMailboxPolidy'> 
                        <executeData> 
                                <name>DialPlan1</name> 
                                <numberOfDigitsInExtension>4</numberOfDigitsInExtension> 
                                <accessTelephoneNumbers> 
                                        <accessTelephoneNumber>5551111<accessTelephoneNumber> 
                                        <accessTelephoneNumber>5551112<accessTelephoneNumber> 
                                </accessTelephoneNumbers> 
                                <preferredDomainController>dc01.fabrikam.local</preferredDomainController>   
                                <faxEnabled>true</faxEnabled> 
                                <generateUMMailboxPolicy>true</generateUMMailboxPolicy> 
                                <ndrEnabled>true</ndrEnabled> 
                                < templateInstance >sourceDialPlan</ templateInstance > 
                                <uriType>SIPName<uriType> 
                                <voIPSecurity>UnSecure<voIPSecurity> 
                        </executeData> 
                </execute> 
        </procedure> 
</request>

Applies To

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0