Use a command line to install Configuration Manager sites
Applies to: Configuration Manager (current branch)
You can run Configuration Manager setup at a command prompt to automate the installation of different kinds of site types. This article provides an overview of the command-line methods.
Supported tasks for command-line installations
Install a central administration site (CAS) or primary site
Modify the languages in use at a CAS or primary site
Recovery a site
Tip
You can also install the Configuration Manager client and console from the command prompt. For more information, see the following articles:
About the command-line script file
For unattended installations of Configuration Manager, you can specify a script file that contains installation options.
Note
You can't use the unattended script file to upgrade an evaluation site to a licensed installation of Configuration Manager.
To use an answer file with setup, first configure the script file with required keys and values. For an unattended installation of a CAS or primary site, the script file requires the following sections:
Identification
Options
SQLConfigOptions
HierarchyExpansionOption
CloudConnectorOptions
SABranchOptions
Then run setup with the command line-option /SCRIPT
and specify a script file.
To recover a site, the script file also uses the RecoveryOptions section.
For a list of keys and values to use in an unattended installation script file, see Unattended setup script file keys.
Note
When you run setup from the CD.Latest
folder for a scripted install or recovery, include the CDLatest
key with a value of 1
. This value isn't supported with installation media from the Microsoft Volume License site. For more information on how to use this key name in the script file, see Command-line options.
Create the script
When you run setup to install a site using the user interface, setup automatically creates the installation script. When you confirm the settings on the Summary page of the wizard, the following actions happen:
- Setup creates the script
%TEMP%\ConfigMgrAutoSave.ini
. You can rename this file before you use it, but it needs the.ini
file extension. - The unattended installation script contains the settings that you selected in the wizard.
- You can modify the script to install other sites in your hierarchy.
- You can use this script to do an unattended setup of Configuration Manager.
This script file provides the same information as the Setup Wizard, except that there are no default settings. Specify all values for the setup keys that are required and necessary for your requirements.
When setup creates the unattended installation script, it includes the product key that you entered in the Setup Wizard. This key can be a valid product key, or EVAL
to install an evaluation version of Configuration Manager. The product key value in the script is required by the prerequisite checker. When setup starts the actual site installation, it clears the product key value in the script. Before using the script for an unattended installation of a new site, edit the script to provide a valid product key or to specify an evaluation installation of Configuration Manager.
Tip
You can also manually create the script file from a plain-text editor like Notepad.
Section names, key names, and values
The script contains section names, key names, and values.
- Required section key names vary depending on the installation type.
- The order of the sections and the order of the keys within sections aren't important.
- The keys aren't case-sensitive.
- When you provide values for keys, the name of the key must be followed by an equal sign (
=
) and the value for the key. For example,CDLatest=1
To view the full set of options, see Command-line options for setup and scripts.
Use a setup script file
To use a setup script file, specify the file name after the /SCRIPT
command-line option.
The script file name requires the
.ini
extension.Provide the full path to the file. For example, if you name the file
setup.ini
, and store it in theC:\Setup
folder, then use the following command line:setup.exe /script C:\Setup\setup.ini
The account that runs setup must have Administrator rights on the computer. When you run setup with the unattended script, open the command prompt window with the Run as administrator option.
Modify languages
To modify the languages that are installed at a site from a command prompt:
- Run setup from
<ConfigMgrInstallationPath>\Bin\X64
on the site server - Use the
/MANAGELANGS
command-line option - Specify a language script file with the languages to add or remove
For example, use the following command syntax: setupwpf.exe /MANAGELANGS <language script file>
For more information values to use in the language script file, see Manage languages.
For more information on languages in Configuration Manager, see Language packs.
Next steps
Command-line options for setup