Setup.exe Configure. Configuration-office2021enterprise.xml
The command setup.exe /configure configuration-Office2021Enterprise.xml is the "secret handshake" for IT professionals deploying Microsoft Office LTSC 2021 (Long-Term Service Channel). Unlike the consumer "click-to-run" installers, this method uses the Office Deployment Tool (ODT) to give admins surgical control over the installation. 🛠️ The Anatomy of the Command
setup.exe: This is the engine of the Office Deployment Tool. You download it as a self-extracting executable from the Microsoft Download Center.
/configure: This switch tells the engine to stop just "existing" and start actually applying settings to a local machine.
configuration-Office2021Enterprise.xml: This is the "instruction manual." It’s a text file that dictates exactly which apps (Word, Excel, etc.) to install, which languages to include, and how to handle licensing. 📝 Why Use an XML File?
Standard installers are "all-or-nothing," but the XML file allows for high-level customization: setup.exe configure. configuration-office2021enterprise.xml
Selective Install: You can exclude apps you don't need (like Publisher or Access) to save space.
Silent Deployment: It can be set to run in the background without any pop-ups, which is perfect for deploying to hundreds of office computers at once.
Licensing Control: It typically handles Volume Licensing (KMS or MAK) automatically, so users never see an "activation" prompt. 🚀 How it Works in Practice
Extract the ODT: Running the downloaded .exe extracts several sample XML files and the master setup.exe into a folder. The command setup
Customize the XML: Admins often use the Office Customization Tool to visually build their XML file instead of coding it by hand.
Run as Admin: You must open a Command Prompt or PowerShell as an administrator, navigate to your folder (cd C:\Office2021), and fire off the command. ⚠️ Pro-Tip: The "Download" Step
Before you can /configure, many admins first run setup.exe /download configuration.xml. This pulls the actual Office installation files (several gigabytes) from Microsoft's servers to your local folder so the final installation is fast and doesn't require an active internet connection. Overview of the Office Deployment Tool - Microsoft 365 Apps
The command setup.exe /configure configuration-office2021enterprise.xml is used to deploy Microsoft Office LTSC 2021 (Long Term Service Channel) to enterprise client computers. This method utilizes the Office Deployment Tool (ODT), a command-line utility that allows IT administrators to customize and control installations that aren't possible through standard installers. Core Components The Office 2021 Enterprise installation files (setup
setup.exe: The executable file for the Office Deployment Tool. It does not contain Office files itself but acts as the engine to download or install them.
configuration-Office2021Enterprise.xml: A sample XML file provided with the ODT specifically for Office 2021 Enterprise (Volume License) products. This file contains the "instructions" for the setup, such as which apps to install (e.g., Word, Excel) and which language to use. How to Use the Configure Command To install Office using these files, follow these steps: Deploy Office Long Term Service Channel (LTSC) 2021
What you need:
- The Office 2021 Enterprise installation files (setup.exe)
- A configuration file (configuration-office2021enterprise.xml)
Step-by-Step Instructions:
14. Recommendations / Best practices (concise)
- Use PerpetualVL2021 channel and pin versions for predictable builds.
- Download payload once to a secured distribution point; install from SourcePath.
- Centralize update control; test patches in a ring before wide deployment.
- Avoid storing PID keys in plaintext; prefer KMS or secure injection.
- Use SCCM/Intune for enterprise rollout and reporting.
- Capture logs and implement detection rules to verify successful installs.
8. Network, performance, and packaging strategies
- Download once, deploy many: store extracted payload on SMB/CIFS or distribution point.
- Use throttling and BITS-friendly methods for mass deployments; ODT itself is not optimized for enterprise scale distribution without a DP or SCCM integration.
- For SCCM/ConfigMgr: use the downloaded payload to create an application/package with install command
setup.exe /configure configuration.xmland detection logic based on Version registry keys or presence of product GUIDs. - Use branch cache or DFS to reduce bandwidth.
Troubleshooting Common Issues
- Error: "The product key entered is not valid..."
- This usually happens if your
Channelis incorrect. Ensure the Channel is set toPerpetualVL2021for Volume Licenses. If you are using a Retail key, the product ID should differ (e.g.,ProPlus2021Retail), but generally, Enterprise deployments use Volume channels.
- This usually happens if your
- "We can't move the file..."
- Close all Office applications currently running on the machine.
- Ensure you are running Command Prompt as Administrator.
- Download stops immediately:
- Check your XML syntax. A missing closing tag
</Add>or typo in the Product ID will cause the tool to exit instantly without error messages.
- Check your XML syntax. A missing closing tag
- Where are the logs?
- By default, logs are stored in
%temp%. Look for files namedSetup(####).logor use the/logflag for detailed output: setup.exe /configure configuration-office2021enterprise.xml /log C:\install.log
- By default, logs are stored in
1. Understanding the Command Structure
Let’s break down the command into its three core components:
setup.exe– The Office Deployment Tool (ODT) bootstrapper. This is not the standard Office installer but a specialized executable downloaded from the Microsoft Volume Licensing Service Center (VLSC)./configure– A command-line switch that tellssetup.exeto read an XML file and apply its instructions (install, uninstall, or modify an existing Office installation).configuration-office2021enterprise.xml– An XML file that defines what to install, where to get the source files, which products and languages, and how to handle updates and logging.
When executed, setup.exe parses the XML, downloads the required bits (if not already cached), and performs the installation silently with the specified parameters.
13. Advanced topics
- Multiproduct coexistence: handling presence of older Office/MSI installs (use Remove element and migration planning).
- Teams: modern Teams behavior in Office 2021 can be managed via ExcludeApp or separate installer for the new Teams (Teams Machine-Wide Installer vs bundled Teams).
- Telemetry and user experience: configuring Display Level and notifications to meet organizational UX policies.
- Compatibility testing: pinned builds in test rings, verify macros, add-ins, and group policies.