Commands › Exchange Online
New-SettingOverride
**Caution**: Incorrect usage of the setting override cmdlets can cause serious damage to your Exchange organization. This damage could require you to reinstall Exchange. Only use these cmdlets as instructed by product documentation or under the direction of Microsoft Customer Service and Support. Use the New-SettingOverride cmdlet to create setting overrides that store Exchange customizations in Active Directory instead of in text files on the server.
Quick start script
# New-SettingOverride — 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-SettingOverride
$before | Format-List
# 3. Make the change (dry run first)
New-SettingOverride -Name <String> -Component <String> -Parameters <MultiValuedProperty> -WhatIf
New-SettingOverride -Name <String> -Component <String> -Parameters <MultiValuedProperty>
# 4. Verify and diff
$after = Get-SettingOverride
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
New-SettingOverride [-Name] <String> -Component <String> -Parameters <MultiValuedProperty> -Reason <String> -Section <String>
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-MaxVersion <Version>]
[-MinVersion <Version>]
[-Server <String[]>]
[-WhatIf]
[<CommonParameters>]Parameters (12)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Name | String | yes | The Name parameter specifies the unique name of the setting override. If the value contains spaces, enclose the value in quotation marks ("). |
| -Component | String | yes | The Component parameter specifies the component that the setting override is applied to. For example: |
| -Parameters | MultiValuedProperty | yes | The Parameters parameter specifies one or more parameters for the override that are available for the combination of the Component and Section parameter values. This parameter uses the syntax:... |
| -Reason | String | yes | The Reason parameter specifies why you are creating the setting override. If the value contains spaces, enclose the value in quotation marks ("). |
| -Section | String | yes | The Section parameter specifies the name of the section for which the override is created. The available values for this parameter depend on the value of the Component parameter. |
| -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... | |
| -Force | SwitchParameter | The Force switch hides warning or confirmation messages. You don't need to specify a value with this switch. | |
| -MaxVersion | Version | The MaxVersion parameter specifies the latest version of Exchange 2016 that this override applies to (up to and including the specified value). | |
| -MinVersion | Version | The MinVersion parameter specifies the earliest version of Exchange 2016 that this override applies to (up to and including the specified value). | |
| -Server | String[] | The Server parameter specifies the name of the Exchange 2016 server where you want the override applied. You can specify a single Exchange 2016 server name, or an array of Exchange 2016 server name wildcards. For... | |
| -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.