Command-line options for Configuration Manager setup
Applies to: Configuration Manager (current branch)
Use this information to configure scripts or to install Configuration Manager from a command line. For more information on how to use these command-line options, see Command-line overview.
Run setup.exe from the \BIN\X64 directory of the Configuration Manager installation path on the site server.
Tip
You can also use setupwpf.exe from the same folder, but it doesn't include basic prerequisite checks.
/DEINSTALL
Uninstall the site. Run setup from the site server computer.
/DONTSTARTSITECOMP
Install a site, but prevent the Site Component Manager service from starting. Until the Site Component Manager service starts, the site isn't active. The Site Component Manager is responsible for installing and starting the SMS_Executive service, and for other processes at the site. After the site install is finished, when you start the Site Component Manager service, it installs the SMS_Executive service and other processes that are necessary for the site to operate.
/HIDDEN
Hide the user interface during setup. Only use this option with the /SCRIPT option. The unattended script file must provide all required options or setup fails.
/NOUSERINPUT
Disable user input during setup, but display the setup wizard. Only use this option with the /SCRIPT option. The unattended script file must provide all required options or setup fails.
/RESETSITE
Run a site reset. This action resets the database and service accounts for the site. For more information, see Run a site reset.
/SQLMOVE
Move the site database. This action moves the site database to a new instance of SQL Server on the same computer, or to a different computer that runs a supported version of SQL Server. For more information, see Modify the site database configuration.
Provide the SQL server name, database name and instance name in the following format:
/SQLMOVE <SQL Server FQDN>:<Database Name>:<SSB Port>
/SQLMOVE <SQL Server FQDN>:<InstanceName>\<Database Name>:<SSB Port>
/TESTDBUPGRADE
Run a test on a backup of the site database to make sure that the database can upgrade.
Important
The test upgrade is no longer a required or recommend step for most sites.
If your database is suspect, or is modified by customizations not explicitly supported by Configuration Manager, continue to use this process.
Don't run this command-line option on your production site database. Running this command-line option on your production site database upgrades the site database and could render your site inoperable.
Provide the instance name and database name for the site database. If you specify only the database name, setup uses the default instance name.
/TESTDBUPGRADE <Instance name>\<Database name>
/TESTDBUPGRADE CM_ABC
/TESTDBUPGRADE Named\CM_ABC
For more information, see Test the database upgrade when installing an update.
/UPGRADE
Run an unattended upgrade of a site. Specify the product key including the dash (-) delimiters. Also specify the path to the previously downloaded setup prerequisite files.
For example: /UPGRADE xxxxx-xxxxx-xxxxx-xxxxx-xxxxx C:\Setup\prereqs
For more information about setup prerequisite files, see Setup Downloader.
/SCRIPT
Run an unattended installation. Use a setup initialization file with this option. For more information about how to run setup unattended, see Install sites using a command line. For more information on the script file keys and values, see Unattended setup script file keys.
For example: /SCRIPT C:\Setup\setup.ini
/SDKINST
Install the SMS Provider on the specified server. Provide the fully qualified domain name (FQDN) for the SMS Provider computer. For more information about the SMS Provider, see Plan for the SMS Provider.
For example: /SDKINST cm02.contoso.com
/SDKDEINST
Uninstall the SMS Provider on the specified computer. Provide the FQDN for the SMS Provider computer.
For example: /SDKDEINST cm01.contoso.com
/MANAGELANGS
Manage the languages that are installed at a previously installed site. Provide the location for the language script file that contains the language settings. For more information, see the Keys to manage languages.
For example: /MANAGELANGS C:\Setup\langsetup.ini
Next steps
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for