GetServiceConfiguration operation
Last modified: July 01, 2013
Applies to: Exchange Online | Exchange Server 2010 | Exchange Server 2013 | Office 365
In this article
GetServiceConfiguration Request Example
GetServiceConfiguration Response Example
GetServiceConfiguration Error Response Example
The GetServiceConfiguration operation gets configuration information for the specified type of service. This operation can return configuration settings for the Unified Messaging, Protection Rules, and Mail Tips services.
Description
The following example of a GetServiceConfiguration request shows how to form a request to get configuration information for the Unified Messaging service.
Code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:RequestServerVersion Version="Exchange2010" />
</soap:Header>
<soap:Body>
<m:GetServiceConfiguration>
<m:RequestedConfiguration>
<m:ConfigurationName>UnifiedMessagingConfiguration</m:ConfigurationName>
</m:RequestedConfiguration>
</m:GetServiceConfiguration>
</soap:Body>
</soap:Envelope>
Description
The following example shows a successful response to the GetServiceConfiguration request.
Code
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="14"
MinorVersion="0"
MajorBuildNumber="639"
MinorBuildNumber="20"
Version="Exchange2010"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<GetServiceConfigurationResponse ResponseClass="Success"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<ResponseMessages>
<ServiceConfigurationResponseMessageType ResponseClass="Success">
<ResponseCode>NoError</ResponseCode>
<m:UnifiedMessagingConfiguration xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<t:UmEnabled xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">true</t:UmEnabled>
<t:PlayOnPhoneDialString xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">user@contoso.com</t:PlayOnPhoneDialString>
<t:PlayOnPhoneEnabled xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">true</t:PlayOnPhoneEnabled>
</m:UnifiedMessagingConfiguration>
</ServiceConfigurationResponseMessageType>
</ResponseMessages>
</GetServiceConfigurationResponse>
</s:Body>
</s:Envelope>
Description
The following example shows an error response to the GetServiceConfiguration request. This error was caused by an incorrect configuration name.
Code
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<s:Fault>
<faultcode xmlns:a="http://schemas.microsoft.com/exchange/services/2006/types">a:ErrorSchemaValidation</faultcode>
<faultstring xml:lang="en-US">The request failed schema validation:
The 'http://schemas.microsoft.com/exchange/services/2006/messages:ConfigurationName' element
is invalid - The value 'UUnifiedMessagingConfiguration' is invalid according to its
datatype 'http://schemas.microsoft.com/exchange/services/2006/types:ServiceConfigurationType'
- The Enumeration constraint failed.</faultstring>
<detail>
<e:ResponseCode xmlns:e="http://schemas.microsoft.com/exchange/services/2006/errors">ErrorSchemaValidation</e:ResponseCode>
<e:Message xmlns:e="http://schemas.microsoft.com/exchange/services/2006/errors">The request failed schema validation.</e:Message>
<t:MessageXml xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<t:LineNumber>13</t:LineNumber>
<t:LinePosition>62</t:LinePosition>
<t:Violation>The 'http://schemas.microsoft.com/exchange/services/2006/messages:ConfigurationName' element
is invalid - The value 'UUnifiedMessagingConfiguration' is invalid according to its
datatype 'http://schemas.microsoft.com/exchange/services/2006/types:ServiceConfigurationType'
- The Enumeration constraint failed.</t:Violation>
</t:MessageXml>
</detail>
</s:Fault>
</s:Body>
</s:Envelope>