Commands › Exchange Online

Set-OutlookProvider

Exchange Online ExchangeOnlineManagement Set-*

Set specific global settings using the msExchOutlookProvider attribute on the msExchAutoDiscoverConfig object in Active Directory.

Quick start script

# Set-OutlookProvider — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-OutlookProvider
$before | Format-List

# 3. Make the change (dry run first)
Set-OutlookProvider -Identity <OutlookProviderIdParameter> -WhatIf
Set-OutlookProvider -Identity <OutlookProviderIdParameter>

# 4. Verify and diff
$after = Get-OutlookProvider
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

Set-OutlookProvider [-Identity] <OutlookProviderIdParameter>
 [-CertPrincipalName <String>]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-Name <String>]
 [-OutlookProviderFlags <OutlookProviderFlags>]
 [-RequiredClientVersions <String[]>]
 [-Server <String>]
 [-TTL <Int32>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (10)

ParameterTypeRequiredWhat it controls
-Identity OutlookProviderIdParameter yes The Identity parameter specifies the ADIDParameter value of the MAPI protocol for which you want to set global settings.
-CertPrincipalName String The CertPrincipalName parameter specifies the Transport Layer Security (TLS) certificate principal name required for connecting to Exchange from an external location.
-Confirm SwitchParameter The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding.
-DomainController Fqdn The DomainController parameter specifies the domain controller that's used by this cmdlet to read data from or write data to Active Directory. You identify the domain controller by its fully qualified domain name...
-Name String The Name parameter specifies a common name for the Outlook Provider Configuration object. This can be a user-friendly name for identification.
-OutlookProviderFlags OutlookProviderFlags The OutlookProviderFlags parameter specifies how Outlook clients should connect to the Exchange server. The value can be set to ServerExclusiveConnect, ExternalClientsRequireSSL, InternalClientsRequireSSL or to None...
-RequiredClientVersions String[] The RequiredClientVersions parameter specifies the minimum version of Microsoft Outlook that's allowed to connect to the Exchange server. This information is in the Autodiscover response to the client connection...
-Server String The Server parameter specifies the Mailbox server to use for Outlook Anywhere clients.
-TTL Int32 The TTL parameter specifies the duration (in hours) that the specified settings are valid.
-WhatIf SwitchParameter The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.