From 6ebeecf034773ccdde1ba7b50c6791b399fa9ec1 Mon Sep 17 00:00:00 2001 From: Frank Rojas <45807133+frankroj@users.noreply.github.com> Date: Thu, 27 Mar 2025 10:31:39 -0400 Subject: [PATCH 1/3] Add where to obtain USMT Add section on how to obtain USMT --- windows/deployment/usmt/usmt-overview.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/windows/deployment/usmt/usmt-overview.md b/windows/deployment/usmt/usmt-overview.md index 0e8726cf9a..0eaa678d6e 100644 --- a/windows/deployment/usmt/usmt-overview.md +++ b/windows/deployment/usmt/usmt-overview.md @@ -7,7 +7,7 @@ author: frankroj ms.reviewer: kevinmi,warrenw manager: aaroncz ms.author: frankroj -ms.date: 01/29/2025 +ms.date: 03/27/2025 ms.topic: overview ms.collection: - highpri @@ -49,6 +49,14 @@ There are some scenarios in which the use of USMT isn't recommended. These scena - Migrations that require end-user interaction. - Migrations that require customization on a machine-by-machine basis. +## Download and install USMT + +USMT is part of the Windows Assessment and Deployment Kit (Windows ADK) and can be downloaded from the following link: + +[Download and install the Windows ADK](/windows-hardware/get-started/adk-install) + +Once the Windows ADK installer is downloaded, run the installer, and then in the **Select the features you want to install** page, make sure **User State Migration Tool (USMT)** is selected. + ## Related articles - [User State Migration Tool (USMT) technical reference](usmt-technical-reference.md). From 91a3831b64bbf137e0e92de7c8e6b99a05a0dc4f Mon Sep 17 00:00:00 2001 From: Frank Rojas <45807133+frankroj@users.noreply.github.com> Date: Thu, 27 Mar 2025 10:39:12 -0400 Subject: [PATCH 2/3] Add section on how to obtain USMT Add section on how to obtain USMT MAXADO-9341090 --- ...started-with-the-user-state-migration-tool.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/windows/deployment/usmt/getting-started-with-the-user-state-migration-tool.md b/windows/deployment/usmt/getting-started-with-the-user-state-migration-tool.md index d1313e2a39..103b3e14b9 100644 --- a/windows/deployment/usmt/getting-started-with-the-user-state-migration-tool.md +++ b/windows/deployment/usmt/getting-started-with-the-user-state-migration-tool.md @@ -8,7 +8,7 @@ ms.service: windows-client author: frankroj ms.topic: get-started ms.subservice: itpro-deploy -ms.date: 01/29/2025 +ms.date: 03/27/2025 appliesto: - ✅ Windows 11 - ✅ Windows 10 @@ -18,7 +18,15 @@ appliesto: This article outlines the general process to follow to migrate files and settings. -## Step 1: Plan the migration +## Step 1: Download and install USMT + +USMT is part of the Windows Assessment and Deployment Kit (Windows ADK) and can be downloaded from the following link: + +[Download and install the Windows ADK](/windows-hardware/get-started/adk-install) + +Once the Windows ADK installer is downloaded, run the installer, and then in the **Select the features you want to install** page, make sure **User State Migration Tool (USMT)** is selected. + +## Step 2: Plan the migration 1. [Plan The Migration](usmt-plan-your-migration.md). Depending on whether the migration scenario is refreshing or replacing computers, an online migration or an offline migration can be chosen. Offline migrations can use either Windows Preinstallation Environment (WinPE) or the files in the **Windows.old** directory. For more information, see [Common Migration Scenarios](usmt-common-migration-scenarios.md). @@ -55,7 +63,7 @@ This article outlines the general process to follow to migrate files and setting 1. Open the `Config.xml` that was generated in the previous step. Review the migration state of each of the components listed in the `Config.xml` file. If necessary, edit the `Config.xml` file and specify `migrate=no` for any components that don't need to be migrated. -## Step 2: Collect files and settings from the source computer +## Step 3: Collect files and settings from the source computer 1. Back up the source computer. @@ -77,7 +85,7 @@ This article outlines the general process to follow to migrate files and setting 1. To ensure that the created store isn't corrupted, run the `UsmtUtils.exe` command with the `/Verify` option. -## Step 3: Prepare the destination computer and restore files and settings +## Step 4: Prepare the destination computer and restore files and settings 1. Install the operating system on the destination computer. From a84001f3d75f9737c7165d5a797c2157a960b7f4 Mon Sep 17 00:00:00 2001 From: Frank Rojas <45807133+frankroj@users.noreply.github.com> Date: Thu, 27 Mar 2025 13:11:09 -0400 Subject: [PATCH 3/3] Add requirement for elevated command prompt Add requirement to run SetupDiag.exe from an elevated command prompt. Also correct example that running SetupDiag.exe without parameters shows interactive help. --- windows/deployment/upgrade/setupdiag.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/windows/deployment/upgrade/setupdiag.md b/windows/deployment/upgrade/setupdiag.md index c66b48114b..140ffb27b7 100644 --- a/windows/deployment/upgrade/setupdiag.md +++ b/windows/deployment/upgrade/setupdiag.md @@ -12,7 +12,7 @@ ms.topic: troubleshooting ms.collection: - highpri - tier2 -ms.date: 01/29/2025 +ms.date: 03/27/2025 appliesto: - ✅ Windows 11 - ✅ Windows 10 @@ -77,6 +77,8 @@ If the upgrade process proceeds normally, the **Sources** directory including ** As long as at least the required version of .NET is installed, no additional action is required, including if a newer version is installed. +1. **Setupdiag.exe** should be run from an elevated command prompt for it to work properly. + ## Using SetupDiag To quickly use SetupDiag on the current computer: @@ -126,7 +128,11 @@ For instructions on how to run the tool in offline mode and with more advanced o ### Examples -- In the following example, SetupDiag is run with default parameters in online mode. The results file is **SetupDiagResults.log** in the same folder where SetupDiag is run. +> [!IMPORTANT] +> +> **SetupDiage.exe** should be run from an elevated command prompt for it to work properly. + +- In the following example, SetupDiag is run without parameters and it displays interactive help. ```cmd SetupDiag.exe