Change the offline address book generation schedule
Applies to: Exchange Server 2016
Topic Last Modified: 2016-03-28
Learn how to configure the offline address book (OAB) update interval in Exchange 2016.
An offline address book (OAB) is a copy of an address book that's been downloaded so that an Outlook user can access the information it contains while disconnected from the server. By default, a new OAB is generated every 8 hours in Exchange Server 2016, but you can change the interval by using the Exchange Management Shell.
For additional management tasks related to OABs, see Offline address book procedures.
Estimated time to complete each procedure: 5 minutes.
You can only use PowerShell to perform this procedure. To learn how to open the Exchange Management Shell in your on-premises Exchange organization, see Open the Exchange Management Shell.
You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Offline address books" entry in the Email address and address book permissions topic.
For information about keyboard shortcuts that may apply to the procedures in this topic, see Keyboard shortcuts in the Exchange admin center.
Use the following syntax in the Exchange Management Shell.
New-SettingOverride -Name <UniqueOverrideName> -Component MailboxAssistants -Section OABGeneratorAssistant -Parameters @("WorkCycle=<Timespan>") -Reason <DescriptiveReason> [-Server <ServerName>]
To specify a <TimeSpan> value, use the syntax
d.hh:mm:ss, where d = days, hh = hours, mm = minutes, and ss = seconds.
To configure the same settings on all Exchange 2016 servers in the Active Directory forest, don't use the Server parameter.
To configure the settings on a specific Exchange 2016 server, use the Server parameter and the server name (don't use the fully qualified domain name or FQDN). This method is useful when you need to specify different settings on different Exchange servers.
This example specifies that the offline address book is generated every two hours on all Exchange 2016 servers in the organization that are responsible for generating offline address books.
Setting override name "OAB Generation Override" (must be unique)
Override reason Generate OAB every 2 hours
New-SettingOverride -Name "OAB Generation Override" -Component MailboxAssistants -Section OABGeneratorAssistant -Parameters @("WorkCycle=02:00:00") -Reason "Generate OAB every 2 hours"
This example specifies the same offline address book generation schedule, but only on the server named Mailbox01.
New-SettingOverride -Name "Mailbox01 OAB Generation Override" -Component MailboxAssistants -Section OABGeneratorAssistant -Parameters @("WorkCycle=02:00:00") -Reason "Generate OAB every 2 hours" -Server Mailbox01
To verify that you've configured the OAB generation schedule on an Exchange 2016 server, run the following command in the Exchange Management Shell, substituting <ServerName> with the server name.
[xml]$diag=Get-ExchangeDiagnosticInfo -Server <ServerName> -Process Microsoft.Exchange.Directory.TopologyService -Component VariantConfiguration -Argument Config; $diag.Diagnostics.Components.VariantConfiguration.Configuration.MailboxAssistants.OABGeneratorAssistant