Applies to: Exchange Server 2013
Topic Last Modified: 2012-07-24
Use the Set-OutlookProvider cmdlet to set specific global settings using the msExchOutlookProvider attribute on the msExchAutoDiscoverConfig object in Active Directory.
For information about the parameter sets in the Syntax section below, see Syntax.
Syntax
Set-OutlookProvider -Identity
<OutlookProviderIdParameter> [-CertPrincipalName
<String>] [-Confirm [<SwitchParameter>]]
[-DomainController <Fqdn>] [-Name <String>]
[-OutlookProviderFlags <None | ServerExclusiveConnect>]
[-Server <String>] [-TTL <Int32>] [-WhatIf
[<SwitchParameter>]]
|
Examples
EXAMPLE 1
This example changes the duration that the Autodiscover service settings are valid for the Microsoft Outlook provider msExchAutoDiscoverConfig.
 Copy Code |
|
|---|---|
Set-OutlookProvider -Identity msExchAutoDiscoverConfig -TTL 2 |
|
Detailed Description
The Set-OutlookProvider cmdlet creates the global settings for the Autodiscover service. It sets the AutoDiscoverConfig object under the Global Settings object in Active Directory and sets the attributes specified in the parameters listed in the Parameters section.
You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Autodiscover service configuration settings" entry in the Clients and Mobile Devices Permissions topic.
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.OutlookProviderIdParameter |
The Identity parameter specifies the ADIDParameter value of the MAPI protocol for which you want to set global settings. |
|
CertPrincipalName |
Optional |
System.String |
The CertPrincipalName parameter specifies the Secure Sockets Layer (SSL) certificate principal name required for connecting to Exchange from an external location. This parameter is only used for Outlook Anywhere clients. |
|
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch. |
|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory. |
|
Name |
Optional |
System.String |
The Name parameter specifies a common name for the Outlook Provider Configuration object. This can be a user-friendly name for identification. |
|
OutlookProviderFlags |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.OutlookProviderFlags |
The OutlookProviderFlags parameter specifies how Outlook
clients should connect to the Exchange server. The value can be set
to |
|
Server |
Optional |
System.String |
The Server parameter specifies the Mailbox server to use for Outlook Anywhere clients. |
|
TTL |
Optional |
System.Int32 |
The TTL parameter specifies the duration (in hours) that the specified settings are valid. If a value is specified, the settings are rediscovered via the Autodiscover service after the duration specified with this parameter. A value of 0 indicates that no rediscovery is required. The default value is 1 hour. |
|
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch. |
Input Types
To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.
Return Types
To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.