Commands › Exchange Online

New-ExchangeSettings

Exchange Online ExchangeOnlineManagement New-*

Create customized Exchange setting objects that are stored in Active Directory. Use the Set-ExchangeSettings cmdlet to configure the actual settings.

Quick start script

# New-ExchangeSettings — 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-ExchangeSettings
$before | Format-List

# 3. Make the change (dry run first)
New-ExchangeSettings -Name <String> -WhatIf
New-ExchangeSettings -Name <String>

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

Syntax

New-ExchangeSettings [-Name] <String>
 [-Confirm]
 [-DomainController <Fqdn>]
 [-Force]
 [-WhatIf]
 [<CommonParameters>]

Parameters (5)

ParameterTypeRequiredWhat it controls
-Name String yes The Name parameter specifies the name of a valid Exchange configuration schema that you want to create an Exchange settings object for. Valid values are
-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.
-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.