Accelerate the discovery and migration of Microsoft workloads to AWS
Created by Ali Alzand
Summary
This pattern shows you how to use the Migration Validator Toolkit PowerShell module
The Migration Validator Toolkit PowerShell module can help your organization reduce the time and effort involved in discovering what applications and services are running on your Microsoft workloads. The module can also help you identify the configurations of your workloads so that you can find out if your configurations are supported on AWS. The module also provides recommendations for next steps and mitigation actions, so that you can avoid any misconfigurations before, during, or after your migration.
Prerequisites and limitations
Prerequisites
Local administrator account
PowerShell 4.0
Limitations
Works only on Microsoft Windows Server 2012 R2 or later
Tools
Tools
PowerShell 4.0
Code repository
The Migration Validator Toolkit PowerShell module for this pattern is available in the GitHub migration-validator-toolkit-for-microsoft-workloads
Epics
Task | Description | Skills required |
---|---|---|
Download, extract, import, and invoke the module. | Choose one of the following methods to download and deploy the module:
Run the PowerShell script In PowerShell, run the following example code:
The code downloads the module from a .zip file. Then, the code extracts, imports, and invokes the module. Download and extract the .zip file
Clone the GitHub repository
| System Administrator |
Invoke the module manually. |
Format-Table
Format-List
Out-GridView
ConvertTo-Csv
| System Administrator |
Task | Description | Skills required |
---|---|---|
Download the .zip file or clone the GitHub repository. | Choose one of the following options:
| System Administrator |
Update the server.csv list. | If you downloaded the .zip file, follow these steps:
| System Administrator |
Invoke the module. | You can use any computer within the domain that uses a domain user that has administrator access to target computers.
The output .csv file is saved in | System Administrator |
Troubleshooting
Issue | Solution |
---|---|
| You can view log files manually in the following location:
|
Related resources
Options, tools, and best practices for migrating Microsoft workloads to AWS (AWS Prescriptive Guidance)
Microsoft migration patterns (AWS Prescriptive Guidance)
Free Cloud Migration Services on AWS
(AWS documentation) Predefined post-launch actions (Application marketing documentation)
Additional information
Frequently asked questions
Where can I run the Migration Validator Toolkit PowerShell module?
You can run the module on Microsoft Windows Server 2012 R2 or later.
When do I run this module?
We recommend that you run the module during the assess phase
Does the module modify my existing servers?
No. All actions in this module are read-only.
How long does it take to run the module?
It typically takes 1–5 minutes to run the module, but it depends on the resource allocation of your server.
What permissions does the module need to run?
You must run the module from a local administrator account.
Can I run the module on physical servers?
Yes, as long as the operating system is Microsoft Windows Server 2012 R2 or later.
How do I run the module at scale for multiple servers?
To run the module on multiple domain-joined computers at scale, follow the steps in the Run the Migration Validator Toolkit PowerShell module on multiple targets epic of this guide. For non domain-joined computers, use a remote invocation or run the module locally by following the steps in the Run the Migration Validator Toolkit PowerShell module on a single target epic of this guide.