note; code

This commit is contained in:
Mandi Ohlinger 2021-12-02 15:40:56 -05:00 committed by GitHub
parent 075fa5f737
commit c857c748e1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -62,7 +62,7 @@ If any of these checks fails, the conversion will not proceed and an error will
## Syntax ## Syntax
>MBR2GPT /validate|convert [/disk:&lt;diskNumber>] [/logs:&lt;logDirectory>] [/map:&lt;source>=&lt;destination>] [/allowFullOS] `MBR2GPT /validate|convert [/disk:<diskNumber>] [/logs:<logDirectory>] [/map:<source>=<destination>] [/allowFullOS]`
### Options ### Options
@ -81,7 +81,7 @@ If any of these checks fails, the conversion will not proceed and an error will
In the following example, disk 0 is validated for conversion. Errors and warnings are logged to the default location, **%windir%**. In the following example, disk 0 is validated for conversion. Errors and warnings are logged to the default location, **%windir%**.
``` ```cmd
X:\>mbr2gpt /validate /disk:0 X:\>mbr2gpt /validate /disk:0
MBR2GPT: Attempting to validate disk 0 MBR2GPT: Attempting to validate disk 0
MBR2GPT: Retrieving layout of disk MBR2GPT: Retrieving layout of disk
@ -102,7 +102,7 @@ In the following example:
>As noted in the output from the MBR2GPT tool, you must make changes to the computer firmware so that the new EFI system partition will boot properly. >As noted in the output from the MBR2GPT tool, you must make changes to the computer firmware so that the new EFI system partition will boot properly.
``` ```cmd
X:\>DiskPart X:\>DiskPart
Microsoft DiskPart version 10.0.15048.0 Microsoft DiskPart version 10.0.15048.0
@ -270,7 +270,10 @@ For more information about partition types, see:
### Persisting drive letter assignments ### Persisting drive letter assignments
The conversion tool will attempt to remap all drive letter assignment information contained in the registry that correspond to the volumes of the converted disk. If a drive letter assignment cannot be restored, an error will be displayed at the console and in the log, so that you can manually perform the correct assignment of the drive letter. **Important**: this code runs after the layout conversion has taken place, so the operation cannot be undone at this stage. The conversion tool will attempt to remap all drive letter assignment information contained in the registry that correspond to the volumes of the converted disk. If a drive letter assignment cannot be restored, an error will be displayed at the console and in the log, so that you can manually perform the correct assignment of the drive letter.
> [!IMPORTANT]
> This code runs after the layout conversion has taken place, so the operation cannot be undone at this stage.
The conversion tool will obtain volume unique ID data before and after the layout conversion, organizing this information into a lookup table. It will then iterate through all the entries in **HKLM\SYSTEM\MountedDevices**, and for each entry do the following: The conversion tool will obtain volume unique ID data before and after the layout conversion, organizing this information into a lookup table. It will then iterate through all the entries in **HKLM\SYSTEM\MountedDevices**, and for each entry do the following:
@ -291,7 +294,10 @@ Four log files are created by the MBR2GPT tool:
- setupact.log - setupact.log
- setuperr.log - setuperr.log
These files contain errors and warnings encountered during disk validation and conversion. Information in these files can be helpful in diagnosing problems with the tool. The setupact.log and setuperr.log files will have the most detailed information about disk layouts, processes, and other information pertaining to disk validation and conversion. Note: The setupact*.log files are different than the Windows Setup files that are found in the %Windir%\Panther directory. These files contain errors and warnings encountered during disk validation and conversion. Information in these files can be helpful in diagnosing problems with the tool. The setupact.log and setuperr.log files will have the most detailed information about disk layouts, processes, and other information pertaining to disk validation and conversion.
> [!NOTE]
> The setupact*.log files are different than the Windows Setup files that are found in the %Windir%\Panther directory.
The default location for all these log files in Windows PE is **%windir%**. The default location for all these log files in Windows PE is **%windir%**.
@ -301,7 +307,7 @@ To view a list of options available when using the tool, type **mbr2gpt /?**
The following text is displayed: The following text is displayed:
``` ```cmd
C:\> mbr2gpt /? C:\> mbr2gpt /?
@ -363,7 +369,7 @@ MBR2GPT has the following associated return codes:
You can type the following command at a Windows PowerShell prompt to display the disk number and partition type. Example output is also shown: You can type the following command at a Windows PowerShell prompt to display the disk number and partition type. Example output is also shown:
``` ```powershell
PS C:\> Get-Disk | ft -Auto PS C:\> Get-Disk | ft -Auto
Number Friendly Name Serial Number HealthStatus OperationalStatus Total Size Partition Style Number Friendly Name Serial Number HealthStatus OperationalStatus Total Size Partition Style
@ -379,7 +385,7 @@ You can also view the partition type of a disk by opening the Disk Management to
If Windows PowerShell and Disk Management are not available, such as when you are using Windows PE, you can determine the partition type at a command prompt with the DiskPart tool. To determine the partition style from a command line, type **diskpart** and then type **list disk**. See the following example: If Windows PowerShell and Disk Management are not available, such as when you are using Windows PE, you can determine the partition type at a command prompt with the DiskPart tool. To determine the partition style from a command line, type **diskpart** and then type **list disk**. See the following example:
``` ```cmd
X:\>DiskPart X:\>DiskPart
Microsoft DiskPart version 10.0.15048.0 Microsoft DiskPart version 10.0.15048.0
@ -428,9 +434,11 @@ To fix this issue, mount the Windows PE image (WIM), copy the missing file from
> You can access the ReAgent files if you have installed the User State Migration Tool (USMT) as a feature while installing Windows Assessment and Deployment Kit. > You can access the ReAgent files if you have installed the User State Migration Tool (USMT) as a feature while installing Windows Assessment and Deployment Kit.
**Command 1:** **Command 1:**
```cmd ```cmd
copy "C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Windows Setup\amd64\Sources\ReAgent*.*" "C:\WinPE_Mount\Windows\System32" copy "C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Windows Setup\amd64\Sources\ReAgent*.*" "C:\WinPE_Mount\Windows\System32"
``` ```
This command copies three files: This command copies three files:
* ReAgent.admx * ReAgent.admx
@ -438,10 +446,13 @@ To fix this issue, mount the Windows PE image (WIM), copy the missing file from
* ReAgent.xml * ReAgent.xml
**Command 2:** **Command 2:**
```cmd ```cmd
copy "C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Windows Setup\amd64\Sources\En-Us\ReAgent*.*" "C:\WinPE_Mount\Windows\System32\En-Us" copy "C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Windows Setup\amd64\Sources\En-Us\ReAgent*.*" "C:\WinPE_Mount\Windows\System32\En-Us"
``` ```
This command copies two files: This command copies two files:
* ReAgent.adml * ReAgent.adml
* ReAgent.dll.mui * ReAgent.dll.mui