GetUserSettings 操作 (SOAP)GetUserSettings operation (SOAP)

• 09/17/2015
• • o

GetUserSettings操作包含对用户的客户端访问配置的查询。The GetUserSettings operation contains a query for users' client access configuration.

GetUserSettings 请求示例GetUserSettings request example

DescriptionDescription

以下 XML 示例显示了自动发现请求正文，该正文请求用户的显示名称、可分辨名称、部署 ID、邮箱服务器、邮箱可分辨名称、Active Directory 服务器、客户端访问服务器版本和受支持的 Exchange Web 服务架构。The following XML example shows an Autodiscover request body that requests a user's display name, distinguished name, deployment ID, mailbox server, mailbox distinguished name, Active Directory server, Client Access server version, and supported Exchange Web Services schemas.

代码Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:a="https://schemas.microsoft.com/exchange/2010/Autodiscover"      
               xmlns:wsa="http://www.w3.org/2005/08/addressing" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"      
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <a:RequestedServerVersion>Exchange2010</a:RequestedServerVersion>
    <wsa:Action>https://schemas.microsoft.com/exchange/2010/Autodiscover/Autodiscover/GetUserSettings</wsa:Action>
    <wsa:To>https://myserver.contoso.com/autodiscover/autodiscover.svc</wsa:To>
  </soap:Header>
  <soap:Body>
    <a:GetUserSettingsRequestMessage xmlns:a="https://schemas.microsoft.com/exchange/2010/Autodiscover">
      <a:Request>
        <a:Users>
          <a:User>
            <a:Mailbox>UserName@domain.contoso.com</a:Mailbox>
          </a:User>
        </a:Users>
        <a:RequestedSettings>
          <a:Setting>UserDisplayName</a:Setting>
          <a:Setting>UserDN</a:Setting>
          <a:Setting>UserDeploymentId</a:Setting>
          <a:Setting>InternalMailboxServer</a:Setting>
          <a:Setting>MailboxDN</a:Setting>
          <a:Setting>ActiveDirectoryServer</a:Setting>
          <a:Setting>CasVersion</a:Setting>
          <a:Setting>EwsSupportedSchemas</a:Setting>
        </a:RequestedSettings>
      </a:Request>
    </a:GetUserSettingsRequestMessage>
  </soap:Body>
</soap:Envelope>

Request 元素Request elements

请求正文中使用以下元素：The following elements are used in the request body:

• GetUserSettingsRequestMessage （SOAP）GetUserSettingsRequestMessage (SOAP)

• 邮箱（SOAP）Mailbox (SOAP)

• 请求 (SOAP)Request (SOAP)

• RequestedServerVersion （SOAP）RequestedServerVersion (SOAP)

• RequestedSettings （SOAP）RequestedSettings (SOAP)

• 设置（SOAP）Setting (SOAP)

• User （SOAP）User (SOAP)

• Users （SOAP）Users (SOAP)

GetUserSettings 响应示例GetUserSettings response example

DescriptionDescription

下面的示例展示了一个成功的GetUserSettings响应。The following example shows a successful GetUserSettings response.

代码Code

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:a="http://www.w3.org/2005/08/addressing">
  <s:Header>
    <a:Action s:mustUnderstand="1">https://schemas.microsoft.com/exchange/2010/Autodiscover/Autodiscover/GetUserSettingsResponse</a:Action>
  </s:Header>
  <s:Body>
  <GetUserSettingsResponseMessage xmlns="https://schemas.microsoft.com/exchange/2010/Autodiscover">
      <Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <ErrorCode>NoError</ErrorCode>
        <ErrorMessage />
        <UserResponses>
          <UserResponse>
            <ErrorCode>NoError</ErrorCode>
            <ErrorMessage>No error.</ErrorMessage>
            <RedirectTarget i:nil="true" />
            <UserSettingErrors />
            <UserSettings>
              <UserSetting i:type="StringSetting">
                <Name>UserDisplayName</Name>
                <Value>UserDisplayName</Value>
              </UserSetting>
              <UserSetting i:type="StringSetting">
                <Name>UserDN</Name>
                <Value>/o=First Organization/ou=Exchange Administrative Group (SDASDASDJ)/cn=Recipients/cn=UserDisplayName</Value>
              </UserSetting>
              <UserSetting i:type="StringSetting">
                <Name>UserDeploymentId</Name>
                <Value>a40E2742-21c6-4050-8Ed2-d41f100c22b8</Value>
              </UserSetting>
              <UserSetting i:type="StringSetting">
                <Name>CasVersion</Name>
                <Value>14.00.0478.000</Value>
              </UserSetting>
              <UserSetting i:type="StringSetting">
                <Name>EwsSupportedSchemas</Name>
                <Value>Exchange2007,  Exchange2010</Value>
              </UserSetting>
              <UserSetting i:type="StringSetting">
                <Name>InternalMailboxServer</Name>
                <Value>machinename.domain.contoso.com</Value>
              </UserSetting>
              <UserSetting i:type="StringSetting">
                <Name>ActiveDirectoryServer</Name>
                <Value>machinename.domain.contoso.com</Value>
              </UserSetting>
              <UserSetting i:type="StringSetting">
                <Name>MailboxDN</Name>
                <Value>/o=First Organization/ou=Exchange Administrative Group (SDASDASDJ)/cn=Configuration/cn=Servers/cn=server/cn=Contoso Pri MDB</Value>
              </UserSetting>
            </UserSettings>
          </UserResponse>
        </UserResponses>
      </Response>
    </GetUserSettingsResponseMessage>
  </s:Body>
</s:Envelope>

Response 元素Response elements

响应正文中使用以下元素：The following elements are used in the response body:

• ErrorCode （SOAP）ErrorCode (SOAP)

• ErrorMessage （SOAP）ErrorMessage (SOAP)

• GetUserSettingsResponseMessage （SOAP）GetUserSettingsResponseMessage (SOAP)

• 名称（SOAP）Name (SOAP)

• RedirectTarget （SOAP）RedirectTarget (SOAP)

• 响应（SOAP）Response (SOAP)

• UserResponse （SOAP）UserResponse (SOAP)

• UserResponses （SOAP）UserResponses (SOAP)

• UserSetting （SOAP）UserSetting (SOAP)

• UserSettingErrors （SOAP）UserSettingErrors (SOAP)

• UserSettings （SOAP）UserSettings (SOAP)

• Value （SOAP）Value (SOAP)

另请参阅See also

GetDomainSettings 操作 (SOAP)GetDomainSettings operation (SOAP)

GetFederationInformation 操作 (SOAP)GetFederationInformation operation (SOAP)

Exchange 2013 的 SOAP 自动发现 XML 元素SOAP Autodiscover XML elements for Exchange 2013