UserOofSettings

Article
03/29/2023

The UserOofSettings element specifies the Out of Office (OOF) settings.

<UserOofSettings>
   <OofState>...</OofState>
   <ExternalAudience>...</ExternalAudience>
   <Duration>...</Duration>
   <InternalReply>...</InternalReply>
   <ExternalReply>...</ExternalReply>
</UserOofSettings>

UserOofSettings

Attributes and elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child elements

Element	Description
OofState	Sets the user's OOF state.
ExternalAudience	Sets or contains a value that determines to whom external OOF messages are sent.
Duration (UserOofSettings)	Specifies the duration for which the OOF status is enabled if the OofState element is set to Scheduled. If the OofState element is set to Enabled or Disabled, the value of this element is ignored.
InternalReply	Contains the OOF response sent to other users in the user's domain or trusted domains.
ExternalReply	Contains the OOF response sent to addresses outside the recipient's domain or trusted domains.

Parent elements

Element	Description
SetUserOofSettingsRequest	Contains the arguments used to set a mailbox user's OOF settings and messages. The following is the XPath expression to this element: `/SetUserOofSettingsRequest`

Remarks

The schema that describes this element is located in the EWS virtual directory of the computer that is running MicrosoftExchange Server 2007 that has the Client Access server role installed.

Example

The following example of a SetUserOofSettings request sets the OoFState to Enabled, sets the duration of OOF for 10 days, and sets the internal and external OOF messages.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <SetUserOofSettingsRequest xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <Mailbox xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
        <Name>David Alexander</Name>
        <Address>someone@example.com</Address>
        <RoutingType>SMTP</RoutingType>
      </Mailbox>
      <UserOofSettings xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
        <OofState>Enabled</OofState>
        <ExternalAudience>All</ExternalAudience>
        <Duration>
          <StartTime>2005-10-05T00:00:00</StartTime>
          <EndTime>2005-10-25T00:00:00</EndTime>
        </Duration>
        <InternalReply>
          <Message>I am out of office.  This is my internal reply.</Message>
        </InternalReply>
        <ExternalReply>
          <Message>I am out of office. This is my external reply.</Message>
        </ExternalReply>
      </UserOofSettings>
    </SetUserOofSettingsRequest>
  </soap:Body>
</soap:Envelope>

Element information

Element	Example
Namespace	https://schemas.microsoft.com/exchange/services/2006/messages
Schema Name	messages schema
Validation File	Messages.xsd
Can be Empty	False