EXOCASMailboxSettings

Parameters

Parameter Attribute DataType Description Allowed Values
Identity Key String The Identity parameter specifies the mailbox that you want to configure.
ActiveSyncAllowedDeviceIDs Write StringArray[] TheActiveSyncAllowedDeviceIDs parameter specifies one or more Exchange ActiveSync device IDs that are allowed to synchronize with the mailbox.
ActiveSyncBlockedDeviceIDs Write StringArray[] The ActiveSyncBlockedDeviceIDs parameter specifies one or more Exchange ActiveSync device IDs that aren't allowed to synchronize with the mailbox.
ActiveSyncDebugLogging Write Boolean The ActiveSyncDebugLogging parameter enables or disables Exchange ActiveSync debug logging for the mailbox.
ActiveSyncEnabled Write Boolean The ActiveSyncEnabled parameter enables or disables access to the mailbox using Exchange ActiveSync.
ActiveSyncMailboxPolicy Write String The ActiveSyncMailboxPolicy parameter specifies the Exchange ActiveSync mailbox policy for the mailbox.
ActiveSyncSuppressReadReceipt Write Boolean The ActiveSyncSuppressReadReceipt parameter controls the behavior of read receipts for Exchange ActiveSync clients that access the mailbox.
EwsAllowEntourage Write Boolean The EwsAllowEntourage parameter enables or disables access to the mailbox by Microsoft Entourage clients that use Exchange Web Services.
EwsAllowList Write StringArray[] The EwsAllowList parameter specifies the Exchange Web Services applications (user agent strings) that are allowed to access the mailbox.
EwsAllowMacOutlook Write Boolean The EwsAllowMacOutlook parameter enables or disables access to the mailbox by Outlook for Mac clients that use Exchange Web Services.
EwsAllowOutlook Write Boolean The EwsAllowOutlook parameter enables or disables access to the mailbox by Outlook clients that use Exchange Web Services.
EwsApplicationAccessPolicy Write String The EwsApplicationAccessPolicy parameter controls access to the mailbox using Exchange Web Services applications.
EwsBlockList Write StringArray[] The EwsBlockList parameter specifies the Exchange Web Services applications (user agent strings) that aren't allowed to access the mailbox using Exchange Web Services.
EwsEnabled Write Boolean The EwsEnabled parameter enables or disables access to the mailbox using Exchange Web Services clients.
ImapEnabled Write Boolean The ImapEnabled parameter enables or disables access to the mailbox using IMAP4 clients.
ImapMessagesRetrievalMimeFormat Write String The ImapMessagesRetrievalMimeFormat parameter specifies the message format for IMAP4 clients that access the mailbox.
ImapForceICalForCalendarRetrievalOption Write Boolean The ImapForceICalForCalendarRetrievalOption parameter specifies how meeting requests are presented to IMAP4 clients that access the mailbox.
ImapSuppressReadReceipt Write Boolean The ImapSuppressReadReceipt parameter controls the behavior of read receipts for IMAP4 clients that access the mailbox.
ImapUseProtocolDefaults Write Boolean The ImapUseProtocolDefaults parameter specifies whether to use the IMAP4 protocol defaults for the mailbox.
MacOutlookEnabled Write Boolean The MacOutlookEnabled parameter enables or disables access to the mailbox using Outlook for Mac clients that use Microsoft Sync technology.
MAPIEnabled Write Boolean The MAPIEnabled parameter enables or disables access to the mailbox using MAPI clients (for example, Outlook).
OneWinNativeOutlookEnabled Write Boolean The OneWinNativeOutlookEnabled parameter enables or disables access to the mailbox using the new Outlook for Windows.
OutlookMobileEnabled Write Boolean The OutlookMobileEnabled parameter enables or disables access to the mailbox using Outlook for iOS and Android.
OWAEnabled Write Boolean The OWAEnabled parameter enables or disables access to the mailbox using Outlook on the web (formerly known as Outlook Web App or OWA).
OWAforDevicesEnabled Write Boolean The OWAforDevicesEnabled parameter enables or disables access to the mailbox using the older Outlook Web App (OWA) app on iOS and Android devices.
OwaMailboxPolicy Write String The OwaMailboxPolicy parameter specifies the Outlook on the web mailbox policy for the mailbox.
PopEnabled Write Boolean The PopEnabled parameter enables or disables access to the mailbox using POP3 clients.
PopForceICalForCalendarRetrievalOption Write Boolean The PopForceICalForCalendarRetrievalOption parameter specifies how meeting requests are presented to POP3 clients that access the mailbox.
PopMessagesRetrievalMimeFormat Write String The PopMessagesRetrievalMimeFormat parameter specifies the message format for POP3 clients that access the mailbox.
PopSuppressReadReceipt Write Boolean The PopSuppressReadReceipt parameter controls the behavior of read receipts for POP3 clients that access the mailbox.
PopUseProtocolDefaults Write Boolean The PopUseProtocolDefaults parameter specifies whether to use the POP3 protocol defaults for the mailbox.
PublicFolderClientAccess Write Boolean The PublicFolderClientAccess parameter enables or disables access to public folders in Microsoft Outlook.
ShowGalAsDefaultView Write Boolean The ShowGalAsDefaultView parameter specifies whether the global address list (GAL) is the default recipient picker for messages.
SmtpClientAuthenticationDisabled Write Boolean The SmtpClientAuthenticationDisabled parameter specifies whether to disable authenticated SMTP (SMTP AUTH) for the mailbox.
UniversalOutlookEnabled Write Boolean The UniversalOutlookEnabled parameter enables or disables access to the mailbox using Windows 10 Mail and Calendar.
Ensure Write String Present ensures the Mailbox CAS settings are applied. Present
Credential Write PSCredential Credentials of the Exchange Global Admin
ApplicationId Write String Id of the Azure Active Directory application to authenticate with.
TenantId Write String Id of the Azure Active Directory tenant used for authentication.
CertificateThumbprint Write String Thumbprint of the Azure Active Directory application's authentication certificate to use for authentication.
CertificatePassword Write PSCredential Username can be made up to anything but password will be used for CertificatePassword
CertificatePath Write String Path to certificate used in service principal usually a PFX file.
ManagedIdentity Write Boolean Managed ID being used for authentication.
AccessTokens Write StringArray[] Access token used for authentication.

Description

This resource configures CAS mailbox settings.

Permissions

Exchange

To authenticate with Microsoft Exchange, this resource required the following permissions:

Roles

  • User Options, View-Only Recipients, Mail Recipients

Role Groups

  • Organization Management

Examples

Example 1

This example is used to test new resources and showcase the usage of new resources being worked on. It is not meant to use as a production baseline.

Configuration Example
{
    param(
        [Parameter()]
        [System.String]
        $ApplicationId,

        [Parameter()]
        [System.String]
        $TenantId,

        [Parameter()]
        [System.String]
        $CertificateThumbprint
    )

    Import-DscResource -ModuleName Microsoft365DSC
    node localhost
    {
        EXOCASMailboxSettings 'AdeleVCasMailboxSettings'
        {
            ActiveSyncAllowedDeviceIDs              = @()
            ActiveSyncBlockedDeviceIDs              = @()
            ActiveSyncDebugLogging                  = $False
            ActiveSyncEnabled                       = $True
            ActiveSyncMailboxPolicy                 = 'Default'
            ActiveSyncSuppressReadReceipt           = $False
            EwsEnabled                              = $True
            Identity                                = "admin@$TenantId"
            ImapEnabled                             = $True # Updated Property
            ImapForceICalForCalendarRetrievalOption = $False
            ImapMessagesRetrievalMimeFormat         = 'BestBodyFormat'
            ImapSuppressReadReceipt                 = $False
            ImapUseProtocolDefaults                 = $True
            MacOutlookEnabled                       = $True
            MAPIEnabled                             = $True
            OutlookMobileEnabled                    = $True
            OWAEnabled                              = $True
            OWAforDevicesEnabled                    = $True
            OwaMailboxPolicy                        = 'OwaMailboxPolicy-Integration'
            PopEnabled                              = $False
            PopForceICalForCalendarRetrievalOption  = $True
            PopMessagesRetrievalMimeFormat          = 'BestBodyFormat'
            PopSuppressReadReceipt                  = $False
            PopUseProtocolDefaults                  = $True
            PublicFolderClientAccess                = $False
            ShowGalAsDefaultView                    = $True
            UniversalOutlookEnabled                 = $True
            Ensure                                  = 'Present'
            ApplicationId         = $ApplicationId
            TenantId              = $TenantId
            CertificateThumbprint = $CertificateThumbprint
        }
    }
}