Contents

ExchangeWebServices

The payload that configures an Exchange Web Services accounts.

Declaration

object ExchangeWebServices

Properties

NameTypeDescription
allowMailDropboolean

If true, the system enables Mail Drop.

AuthenticationCertificateUUIDstring

The UUID of the certificate payload within the same profile to use for the identity credential. Supported on macOS 10.11 or later. On macOS 10.12 or later use the PayloadCertificateUUID.

EmailAddressstring

The full email address for the account. If the email address string isn’t present in the payload, the device prompts for it during profile installation.

ExternalHoststring

The external server address.

ExternalPathstring

The external server path.

ExternalPortinteger

The external server port number.

ExternalSSLboolean

If true, the system enables SSL for connections to the external server.

Hoststring

The Exchange server host name or IP address. Ignored if using OAuth.

OAuthboolean

If true, the system enables OAuth for authentication. Don’t specify a password if OAuth is true. Available in macOS 10.14 and later

OAuthSignInURLstring

The URL to load into a web view for authentication through OAuth when autodiscovery isn’t used. This setting requires a Host value.

Passwordstring

The password of the account. Use only with encrypted profiles.

Pathstring

The server path.

PayloadCertificateUUIDstring

The UUID of the certificate payload within the same profile to use for the identity credential. Supported on macOS 10.12 or later.

Portinteger

The server port number.

SSLboolean

If true, the system enables SSL.

UserNamestring

The user name for this Exchange account. Required for noninteractive installation, such as through MDM. If missing, the system prompts the user for it during interactive profile installation.

Discussion

Specify com.apple.ews.account as the payload type.

Profile availability

Device channel

NA

User channel

macOS

Allow manual install

macOS

Requires supervision

NA

Requires user-approved MDM

NA

Allowed in user enrollment

macOS

Allow multiple payloads

macOS

Profile example

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>PayloadContent</key>
    <array>
        <dict>
            <key>EmailAddress</key>
            <string>juanchavez4@companyemail.com</string>
            <key>ExternalHost</key>
            <string>host.example.com</string>
            <key>ExternalPath</key>
            <string></string>
            <key>ExternalSSL</key>
            <true/>
            <key>Host</key>
            <string>host.example.com</string>
            <key>MailNumberOfPastDaysToSync</key>
            <integer>0</integer>
            <key>Password</key>
            <string>Password123</string>
            <key>PayloadDisplayName</key>
            <string>Exchange Web Service</string>
            <key>PayloadIdentifier</key>
            <string>com.example.myewspayload</string>
            <key>PayloadType</key>
            <string>com.apple.ews.account</string>
            <key>PayloadUUID</key>
            <string>bb4adbbc-5516-45bb-bdee-cc7e47a5c5b5</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
            <key>SSL</key>
            <true/>
            <key>UserName</key>
            <string>juanchavez4@companyemail.com</string>
        </dict>
    </array>
    <key>PayloadDisplayName</key>
    <string>Exchange Web Service</string>
    <key>PayloadIdentifier</key>
    <string>com.example.myprofile</string>
    <key>PayloadType</key>
    <string>Configuration</string>
    <key>PayloadUUID</key>
    <string>ccb3eded-4486-4af8-81a3-add2d39cdfe7</string>
    <key>PayloadVersion</key>
    <integer>1</integer>
</dict>
</plist>

See Also

Mail