Udostępnij za pośrednictwem

Use unattended mode in Exchange Setup

  • Artykuł

Running Exchange Setup from the command line allows you to automate the installation of Exchange do and other related tasks on Exchange servers (for example, remove an existing Exchange server or recover a failed Exchange server).

This topic describes the available command line switches, and provides examples.

For more information about planning for Exchange 2016 or Exchange 2019, see Planning and deployment for Exchange Server.

For information about tasks to complete after installation, see Exchange Server post-installation tasks.

Primary command line switches for unattended mode

The primary (top-level, scenario-defining) command line switches that are available in unattended Setup mode in Exchange 2016 or Exchange 2019 are described in the following table:

Switch Description
/IAcceptExchangeServerLicenseTerms Note: Beginning with the September 2021 Cumulative Updates, this switch is no longer available in Exchange Server 2016 or Exchange Server 2019.

This switch is required in all unattended setup commands (whenever you run Setup.exe with any additional switches). If you don't use this switch, you'll get an error. To read the license terms, visit Microsoft License Terms.
/IAcceptExchangeServerLicenseTerms_DiagnosticDataON
/IAcceptExchangeServerLicenseTerms_DiagnosticDataOFF		 Note: These switches are available beginning with the September 2021 Cumulative Updates for Exchange Server 2016 and Exchange Server 2019.

One of these switches is required in all unattended setup commands (whenever you run Setup.exe with any additional switches). If you don't use one of these switches, you'll get an error. To read the license terms, visit Microsoft License Terms.

To accept the license terms and send diagnostic data to Microsoft use the switch with suffix DiagnosticDataON.

To accept the license terms but not send diagnostic data to Microsoft use the switch with suffix DiagnosticDataOFF.
/Mode:<InstallationMode>
(or /m:<InstallationMode>)		 Valid values are:
  • Install: Installs Exchange on a new server using the Exchange server roles specified by the /Roles switch. This is the default value if the command doesn't use the /Mode switch.
  • Uninstall: Uninstalls Exchange from a working server.
  • Upgrade: Installs a Cumulative Update (CU) on an Exchange server.
  • RecoverServer: Recovers an Exchange server using the existing Exchange server object in Active Directory after a catastrophic hardware or software failure on the server. For instructions, see Recover Exchange servers.
/Roles:<ServerRole>
(or /Role:<ServerRole> or /r:<ServerRole>)		 This switch is required in /Mode:Install commands. Valid values are:
  • Mailbox (or mb): Installs the Mailbox server role and the Exchange management tools on the local server. This is the default value. You can't use this value with EdgeTransport.
  • EdgeTransport (or et): Installs the Edge Transport server role and the Exchange management tools on the local server. You can't use this value with Mailbox.
  • ManagementTools (or mt or t): Installs the Exchange management tools on clients or other Windows servers that aren't running Exchange.
/PrepareAD (or /p)
/PrepareSchema (or /ps)
/PrepareDomain:<DomainFQDN> (or /pd:<DomainFQDN>)
/PrepareAllDomains (or /pad)		 Use these switches to extend the Active Directory schema for Exchange, prepare Active Directory for Exchange, and prepare some or all Active Directory domains for Exchange. For more information, see Prepare Active Directory and domains for Exchange
/NewProvisionedServer[:<ServerName>] (or /nprs[:<ServerName>]
/RemoveProvisionedServer:<ServerName> (or /rprs:<ServerName>)		 The /NewProvisionedServer switch creates the Exchange server object in Active Directory. After that, a member of the Delegated Setup role group can install Exchange on the server. For more information, see Delegate the installation of Exchange servers.

The /RemoveProvisionedServer switch removes a provisioned Exchange server object from Active Directory before Exchange is installed on the server.
/AddUmLanguagePack:<Culture1>,<Culture2>...<CultureN>
/RemoveUmLanguagePack:<Culture1>,<Culture2>...<CultureN>		 Note: These switches aren't available in Exchange 2019. They're only available in Exchange 2016.

Adds or removes Unified Messaging (UM) language packs from existing Exchange 2016 Mailbox servers. UM language packs enable callers and Outlook Voice Access users to interact with the UM system in those languages. You can't add or remove the en-US language pack.
You can install language packs on existing Mailbox servers by using the /AddUmLanguagePack switch or by running the UMLanguagePack.<Culture>.exe file directly. You can only remove installed language packs by using the /RemoveUmLanguagePack switch. For more information, see UM languages, prompts, and greetings.

Optional command line switches for unattended mode

The optional (supporting) command line switches that are available in unattended Setup mode in Exchange 2016 or Exchange 2019 are described in the following table:

Switch Valid values Default value Available with Description
/ActiveDirectorySplitPermissions:<TrueOrFalse> True or False False /Mode:Install /Roles:Mailbox or /PrepareAD commands for the first Exchange server in the organization. Specifies the Active Directory split permissions model when preparing Active Directory. For more information, see the "Active Directory split permissions" section in Understanding split permissions.
/AdamLdapPort:<TCPPortNumber> A valid TCP port number 50389 /Mode:Install /Roles:EdgeTransport commands Specifies a custom LDAP port to use for the Active Directory Lightweight Directory Services (AD LDS) instance on Edge Transport servers. The value is stored in the registry at HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ExchangeServer\v15\EdgeTransportRole\AdamSettings\MSExchange\LdapPort.
/AdamSslPort:<TCPPortNumber> A valid TCP port number 50636 /Mode:Install /Roles:EdgeTransport commands Specifies a custom SSL (TLS) port to use for the AD LDS instance on Edge Transport servers. The value is stored in the registry at HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ExchangeServer\v15\EdgeTransportRole\AdamSettings\MSExchange\SslPort.
/AnswerFile:"<PathAndFileName>"
(or af:"<PathAndFileName>")		 The name and location of a text file (for example,"D:\Server data\answer.txt"). n/a /Mode:Install /Roles:Mailbox or /Mode:Install /Roles:EdgeTransport commands Use this switch to create a text file that you can use to install Exchange on multiple computers with the same settings. You can use the following switches in the answer file: AdamLdapPort, AdamSslPort, CustomerFeedbackEnabled, DbFilePath, DisableAMFiltering, DoNotStartTransport, EnableErrorReporting, IAcceptExchangeServerLicenseTerms, LogFolderPath, Mdbname, OrganizationName, TenantOrganizationConfig, and UpdatesDir. Don't use the forward slash character ( / ) with the switches in the answer file. Put each switch or switch/value pair on one line in the file.
/CustomerFeedbackEnabled:<TrueOrFalse> True or False False /Mode:Install and /PrepareAD commands Specifies whether to allow or prevent Exchange from providing usage feedback to Microsoft to help improve future Exchange features. You can enable or disable error reporting on the server after setup is complete by using the ErrorReportingEnabled parameter on the Set-ExchangeServer cmdlet.
/DoNotEnableEP n/a n/a /Mode:Install and /Mode:Upgrade Can be used to skip enabling Extended Protection during Exchange Server setup. The parameter is available with Exchange Server 2019 CU14 (or later) and can be used on Exchange Server 2019 Mailbox server.
/DoNotEnableEP_FEEWS n/a n/a /Mode:Install and /Mode:Upgrade Can be used to skip enabling Extended Protection on the Front-End EWS virtual directory. The parameter is available with Exchange Server 2019 CU14 (or later) and should only be used on Exchange Servers, which are published via Hybrid Agent. It can only be used on Exchange Server 2019 Mailbox server.
/DbFilePath:"<Path>\<FileName>.edb" A folder path and an .edb filename (for example, "D:\Exchange Database Files\DB01\db01.edb"). %ExchangeInstallPath%Mailbox\<DatabaseName>\<DatabaseName>.edb where:
  • <DatabaseName> is Mailbox Database <10DigitNumber> that matches the default name of the database or the value you specified with the /MdbName switch (without the .edb file name extension).
  • %ExchangeInstallPath% is %ProgramFiles%\Microsoft\Exchange Server\V15\ or the location you specified with the /TargetDir switch.
 /Mode:Install /Roles:Mailbox commands Specifies the location of the first mailbox database that's created on the new Mailbox server. You can specify the name of the database file with the /MdbName switch and the location of the database transaction log files with the /LogFolderPath switch.
/DisableAMFiltering n/a n/a /Mode:Install /Roles:Mailbox commands Disables the built-in Exchange antimalware filtering on Mailbox servers. For more information about antimalware filtering, see Antimalware protection in Exchange Server.
/DomainController:<ServerNameOrFQDN>
(or /dc:<ServerNameOrFQDN>)		 The server name (for example, DC01) or FQDN (for example, dc01.contoso.com) of the domain controller. A randomly selected domain controller in the same Active Directory site as the target server where you're running Setup. All /Mode commands (except when you're installing an Edge Transport server) or /PrepareAD, /PrepareSchema, /PrepareDomain and /PrepareAllDomains commands Specifies the domain controller that Exchange Setup uses to read from and write to Active Directory. The domain controller must meet the minimum requirements for Exchange 2016 or Exchange 2019.

If you use this switch in /PrepareSchema or /PrepareAD commands that extend the Active Directory schema for Exchange, you must specify the schema master; otherwise, you'll get an error.
/DoNotStartTransport n/a n/a /Mode:Install /Roles:Mailbox, /Mode:Install /Roles:EdgeTransport, and /Mode:RecoverServer commands. Tells Setup to not start the Microsoft Exchange Transport service (mail flow) on Mailbox servers or Edge Transport servers after Setup is complete. You can use this switch to configure additional settings before the server accepts email messages (for example, configure antispam agents or move the queue database back onto a recovered Exchange server.)
/EnableErrorReporting n/a Disabled /Mode:Install, /Mode:Upgrade, and /Mode:RecoverServer commands Specifies whether to allow Exchange to automatically check online for solutions to errors that it encounters. You can enable or disable error reporting on the server after setup is complete by using the ErrorReportingEnabled parameter on the Set-ExchangeServer cmdlet.
/InstallWindowsComponents n/a n/a /Mode:Install commands Installs the required Windows roles and features for the specified Exchange server role. If a reboot is required, Setup will resume where the installation ended.
/LogFolderPath:"<Path>" A folder path (for example, "E:\Exchange Database Logs"). %ExchangeInstallPath%Mailbox\<DatabaseName> where:
  • <DatabaseName> is Mailbox Database <10DigitNumber> that matches the default name of the database or the value you specified with the /MdbName switch (without the .edb file name extension).
  • %ExchangeInstallPath% is %ProgramFiles%\Microsoft\Exchange Server\V15\ or the location you specified with the /TargetDir switch.
 /Mode:Install /Roles:Mailbox commands Specifies the location of the transaction log files for the first mailbox database that's created on the new Mailbox server. You can specify the location of the database files with the /DbFilePath switch.
/MdbName:"<FileName>" A database filename without the .edb extension (for example, "db01") Mailbox Database <10DigitNumber> (for example, Mailbox Database 0139595516). /Mode:Install /Roles:Mailbox commands Specifies the name of the first mailbox database that's created on the new Mailbox server. You can specify the location of the database files with the /DbFilePath switch.
/OrganizationName:"<Organization Name>"
(or /on:"<Organization Name>")		 A text string (for example, "Contoso Corporation"). Blank in command line setup; First Organization in the Exchange Setup wizard. /Mode:Install /Roles:Mailbox or /PrepareAD commands for the first Exchange server in the organization. The organization name is used internally by Exchange, isn't typically seen by users, doesn't affect the functionality of Exchange, and doesn't determine what you can use for email addresses.
  • The organization name can't contain more than 64 characters, and can't be blank.
  • Valid characters are A to Z, a to z, 0 to 9, hyphen or dash (-), and space, but leading or trailing spaces aren't allowed.
  • You can't change the organization name after it's set.
/SourceDir:"<Path>"
(or /s:"<Path>")		 A folder path (for example, "Z:\Exchange). The ServerRoles\UnifiedMessaging folder on the Exchange installation media. /AddUmLanguagePack commands in Exchange 2016 (not available in Exchange 2019) Specifies the location of the language packs (UMLanguagePack.<Culture>.exe files) to install on existing Exchange 2016 Mailbox servers.
/TargetDir:"<Path>"
(or /t:"<Path>")		 A folder path (for example, "D:\Program Files\Microsoft\Exchange"). %ProgramFiles%\Microsoft\Exchange Server\V15\ /Mode:Install and /Mode:RecoverServer commands Specifies where to install Exchange on the server. You can't install Exchange in the root of a drive (for example, C:\), or on a ROM drive, RAM disk, network drive, removable disk, or unknown drive type.
When you recover a failed Exchange server that was installed using a custom installation path, you need to use this switch to specify the custom path during the recovery.
/TenantOrganizationConfig:"<Path>" A folder path (for example "C:\Data") n/a /Mode:Install or /PrepareAD commands. Required in hybrid deployments between on-premises organizations and Microsoft 365 or Office 365 to specify the location of the text file that contains the configuration information for your Microsoft 365 or Office 365 organization. You create this file by running the Get-OrganizationConfig cmdlet in Exchange Online PowerShell in your Microsoft 365 or Office 365 organization.
/UpdatesDir:"<Path>"
(or /u:"<Path>")		 A folder path (for example, "D:\Downloads\Exchange Updates"). The Updates folder at the root of the Exchange installation media. /Mode:Install, /Mode:Upgrade, /Mode:RecoverServer, and /AddUmLanguagePack commands. Specifies the source location of updates for Setup to install. You can only specify one folder for updates.

Any UM language packs located in this folder will be automatically installed on the target Exchange 2016 Mailbox server.

What do you need to know before you begin?

  • Download the latest version of Exchange on the target computer. For more information, see Updates for Exchange Server.

  • Verify the network, computer hardware, operating system, and software requirements at: Exchange Server system requirements and Exchange Server prerequisites.

  • Verify that you've read the release notes at Release notes for Exchange Server.

    Caution

    After you install Exchange on a server, you must not change the server name. Renaming a server after you've installed an Exchange server role is not supported.

  • For Mailbox servers:

    • Estimated time to complete: 60 minutes

    • The target server must be a member of an Active Directory domain.

    • The account that you use to install Exchange requires the following permissions:*:

      * Members of the Delegated Setup role group can install Exchange on servers that have already been provisioned in Active Directory by an Exchange administrator. For more information, see Delegate the installation of Exchange servers.

  • For Edge Transport servers:

    • Estimated time to complete: 40 minutes

    • We recommend that you install Edge Transport servers in a perimeter network that's outside of your organization's internal Active Directory forest. Installing the Edge Transport server role on domain-joined computers only enables domain management of Windows features and settings. Edge Transport servers don't directly access Active Directory. Instead, they use Active Directory Lightweight Directory Services (AD LDS) to store configuration and recipient information. For more information about the Edge Transport role, see Edge Transport servers.

    • Verify the local account on the target computer is a member of the local Administrators group on the target server.

    • You need to configure the primary DNS suffix on the computer. For example, if the fully qualified domain name of your computer is edge.contoso.com, the DNS suffix for the computer is contoso.com. For more information, see Primary DNS Suffix is missing [ms.exch.setupreadiness.FqdnMissing].

    • In coexistence scenarios, Exchange 2010 Hub Transport servers need an update before you can subscribe an Exchange 2016 Edge Transport server to an Active Directory site that contains Exchange 2010 Hub Transport servers. If you don't install this update, the EdgeSync Subscription won't work correctly for Exchange 2010 Hub Transport server that participates in EdgeSync synchronization. For more information, see Supported coexistence scenarios for Exchange 2016.

  • For information about keyboard shortcuts that may apply to the procedures in this topic, see Keyboard shortcuts in the Exchange admin center.

Use Setup.exe to install Exchange in unattended mode

  1. On the target server, open File Explorer, right-click on the Exchange ISO image file that you downloaded, and then select Mount. Note the virtual DVD drive letter that's assigned.

  2. Open a Windows Command Prompt window. For example:

    • Press the Windows key + 'R' to open the Run dialog, type cmd.exe, and then press OK.

    • Press Start. In the Search box, type Command Prompt, then in the list of results, select Command Prompt.

  3. In the Command Prompt window, use the following syntax:

    <Virtual DVD drive letter>:\Setup.exe /IAcceptExchangeServerLicenseTerms_DiagnosticDataON [Switches]

    Setup copies the setup files to the local computer.

    Setup checks the prerequisites, including all prerequisites specific to the server roles that you're installing. If you haven't met all the prerequisites, Setup fails and returns an error message that explains the reason for the failure. If you've met all the prerequisites, Setup installs Exchange.

  4. Restart the server after the Exchange installation is complete.

  5. Complete your deployment by performing the tasks provided in Exchange Server post-installation tasks.

Unattended mode examples

Prepare Active Directory for Exchange in unattended mode

This example configures "Fabrikam Ltd" as the Exchange organization name in Active Directory and prepares Active Directory for the version of Exchange that's being installed.

Setup.exe /IAcceptExchangeServerLicenseTerms_DiagnosticDataON /PrepareAD /OrganizationName:"Fabrikam Ltd"

For more information, see Prepare Active Directory and domains for Exchange.

Install Mailbox servers in unattended mode

  • This example installs the first Exchange server (Mailbox server) in the organization, configures "Contoso Corporation" as the Exchange organization name in Active Directory, and installs the Exchange management tools on the local server.

    Setup.exe /IAcceptExchangeServerLicenseTerms_DiagnosticDataON /Mode:Install /Roles:Mailbox /on:"Contoso Corporation"

  • This example installs the Mailbox server role and the management tools in the default folder on the local server in an organization where Active Directory has already been prepared for the version of Exchange that's being installed.

    Setup.exe /IAcceptExchangeServerLicenseTerms_DiagnosticDataON /mode:Install /r:MB

  • This example installs the Mailbox server role and the management tools in the "C:\Exchange Server" folder on the local server.

    Setup.exe /IAcceptExchangeServerLicenseTerms_DiagnosticDataON /Mode:Install /Role:Mailbox /TargetDir:"C:\Exchange Server"

  • This example installs the Mailbox server role on the local server by using the settings in the ExchangeConfig.txt file.

    Setup.exe /IAcceptExchangeServerLicenseTerms_DiagnosticDataON /mode:Install /role:Mailbox /AnswerFile:c:\ExchangeConfig.txt

  • This example uses the domain controller named DC01 to read from and write to Active Directory while installing the Mailbox server role and the management tools on the local server.

    Setup.exe /IAcceptExchangeServerLicenseTerms_DiagnosticDataON /mode:Install /role:Mailbox /DomainController:DC01

  • This example updates Exchange Setup with patches from the specified folder, and then installs the Mailbox server role and the management tools on the local server. In Exchange 2016 only, if any UM language packs are located in this folder, the language packs are automatically installed.

    Setup.exe /IAcceptExchangeServerLicenseTerms_DiagnosticDataON /role:Mailbox /UpdatesDir:"C:\ExchangeServer\New Patches"

Install Edge Transport servers in unattended mode

  • This example installs the Edge Transport server role and the management tools in the default location on the local server.

    Setup.exe /IAcceptExchangeServerLicenseTerms /mode:Install /r:EdgeTransport

  • This example installs the Edge Transport server role and the management tools in the specified folder on the local server.

    Setup.exe /IAcceptExchangeServerLicenseTerms /mode:Install /r:ET /TargetDir:"D:\Exchange Server"

Uninstall Exchange from servers in unattended mode

This example completely removes Exchange from the local server and removes the server's Exchange configuration from Active Directory.

Setup.exe /mode:Uninstall

Remove provisioned Exchange server objects from Active Directory in unattended mode

This example removes the provisioned Exchange server object named Exchange03 from Active Directory before Exchange is installed on the server (if Exchange is already installed on the server, the command won't work).

Setup.exe /rprs:Exchange03

For more information, see Delegate the installation of Exchange servers.

Add and remove UM language packs from existing Exchange 2016 Mailbox servers in unattended mode

Note

These procedures aren't available in Exchange 2019.

  • This example installs the Russian and Spain Spanish language packs on the local Exchange 2016 Mailbox server from the specified folder.

    Setup.exe /IAcceptExchangeServerLicenseTerms_DiagnosticDataON /AddUmLanguagePack:ru-RU,es-ES /SourceDir:"D:\UM Language Packs"

  • This example uninstalls the Korean UM language pack from the local Exchange 2016 Mailbox server.

    Setup.exe  /RemoveUmLanguagePack:ko-KR

Next steps