adding new files

Author: rayne-wiselman

articles/migrate/deploy-appliance-script.md

@@ -11,16 +11,16 @@ ms.date: 03/23/2020
 This article describes how to set up the [Azure Migrate appliance](deploy-appliance.md) using a PowerShell installer script.
 
 The script provides:
-- An alternative to setting up the appliance using a OVA template, for assessment and agentless migration of VMware VMs.
+- An alternative to setting up the appliance using an OVA template, for assessment and agentless migration of VMware VMs.
 - An alternative to setting up the appliance using a VHD template, for assessment and migration of Hyper-V VMs.
-- For assessment of physical servers, the script is the only method available for setting up the appliance.
+- For assessment of physical servers (or VMs that you want to migrate as physical servers), the script is the only method for setting up the appliance.
 
 ## Prerequisites
 
 The script sets up the Azure Migrate appliance on an existing physical machine or VM.
 
-- The machine on which you run the script to set up the appliance must be running Windows Server 2016, with 32 GB of memory, eight vCPUs, around 80 GB of disk storage, and an external virtual switch. 
-- Before you start, review appliance requirements for [VMware VMs](migrate-appliance.md#appliance---vmware), [Hyper-V VMs](migrate-appliance.md#appliance---hyper-v), and [physical servers](migrate-appliance.md#appliance---physical).
+- The machine that will act as the appliance must be running Windows Server 2016, with 32 GB of memory, eight vCPUs, around 80 GB of disk storage, and an external virtual switch. It requires a static or dynamic IP address, and access to the internet.
+- Before you deploy the appliance, review detailed appliance requirements for [VMware VMs](migrate-appliance.md#appliance---vmware), [Hyper-V VMs](migrate-appliance.md#appliance---hyper-v), and [physical servers](migrate-appliance.md#appliance---physical).
 - Don't run the script on an existing Azure Migrate appliance.
 
 
@@ -41,7 +41,7 @@ Check that the zipped file is secure, before you deploy it.
     - ```C:\>CertUtil -HashFile <file_location> [Hashing Algorithm]```
     - Example usage: ```C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller.zip SHA256```
 
-3. Verify that the generated hash values match these settings (these are for the latest appliance version):
+3. Verify that the generated hash values match these settings (for the latest appliance version):
 
     **Algorithm** | **Hash value**
       --- | ---
@@ -50,20 +50,20 @@ Check that the zipped file is secure, before you deploy it.
 
 ## Run the script
 
-Run the installer script to:
+Here's what the script does:
 
 - Installs agents and a web application.
-- Install Windows roles, including Windows Activation Service, IIS, and PowerShell ISE.
-- Download and installs an IIS rewritable module. [Learn more](https://www.microsoft.com/download/details.aspx?id=7435).
-- Updates a registry key (HKLM), with persistent setting details for Azure Migrate.
+- Installs Windows roles, including Windows Activation Service, IIS, and PowerShell ISE.
+- Downloads and installs an IIS rewritable module. [Learn more](https://www.microsoft.com/download/details.aspx?id=7435).
+- Updates a registry key (HKLM), with persistent settings for Azure Migrate.
 - Creates log and configuration files as follows:
     - **Config Files**: %ProgramData%\Microsoft Azure\Config
     - **Log Files**: %ProgramData%\Microsoft Azure\Logs
 
 To run the script:
 
 1. Extract the zipped file to a folder on the machine that will host the appliance.
-2. Launch PowerShell with administrator (elevated) privileges.
+2. Launch PowerShell on the machine, with administrator (elevated) privileges.
 3. Change the PowerShell directory to the folder containing the contents extracted from the downloaded zipped file.
 4. Run the script **AzureMigrateInstaller.ps1** as follows:
 
@@ -83,4 +83,8 @@ To run the script:
 
 ## Next steps
 
-After you've set up the appliance using the script, follow the instructions to configure the appliance for [VMware](how-to-set-up-appliance-vmware.md#configure-the-appliance), [Hyper-V](how-to-set-up-appliance-hyper-v.md#configure-the-appliance), or physical servers for the first time.
+After you've set up the appliance using the script, follow these instructions:
+
+- Set up the appliance for [VMware](how-to-set-up-appliance-vmware.md#configure-the-appliance).
+- Set up the appliance for [Hyper-V](how-to-set-up-appliance-hyper-v.md#configure-the-appliance).
+- Set up the appliance for [physical servers](how-to-set-up-appliance-physical.md).

articles/migrate/how-to-set-up-appliance-hyper-v.md

@@ -2,13 +2,13 @@
 title: Set up an Azure Migrate appliance for Hyper-V
 description: Learn how to set up an Azure Migrate appliance to assess and migrate Hyper-V VMs.
 ms.topic: article
-ms.date: 11/19/2019
+ms.date: 03/23/2023
 ---
 
 
 # Set up an appliance for Hyper-V VMs
 
-This article describes how to set up the Azure Migrate appliance for assessment of Hyper-V VMs, using the [Azure Migrate:Server Assessment](migrate-services-overview.md#azure-migrate-server-assessment-tool) tool.
+This article describes how to set up the Azure Migrate appliance for assessment of Hyper-V VMs with the [Azure Migrate:Server Assessment](migrate-services-overview.md#azure-migrate-server-assessment-tool) tool.
 
 The [Azure Migrate appliance](migrate-appliance.md)  is a lightweight appliance used by Azure Migrate:Server Assessment/Migration to discover on-premises Hyper-V VMs, and send VM metadata/performance data to Azure.
 

articles/migrate/how-to-set-up-appliance-vmware.md

@@ -2,15 +2,15 @@
 title: Set up an Azure Migrate appliance for VMware 
 description: Learn how to set up an Azure Migrate appliance to assess and migrate VMware VMs.
 ms.topic: article
-ms.date: 11/18/2019
+ms.date: 03/23/2020
 ---
 
 
 # Set up an appliance for VMware VMs
 
-This article describes how to set up the Azure Migrate appliance for assessment and agentless migration of VMware VMs, using the [Azure Migrate:Server Assessment](migrate-services-overview.md#azure-migrate-server-assessment-tool) tool.
+This article describes how to set up the Azure Migrate appliance for assessment with the [Azure Migrate:Server Assessment](migrate-services-overview.md#azure-migrate-server-assessment-tool) tool, and for agentless migration using the [Azure Migrate:Server Migration](migrate-services-overview.md#azure-migrate-server-migration-tool) tool.
 
-The [Azure Migrate appliance](migrate-appliance.md)  is a lightweight appliance used by Azure Migrate:Server Assessment/Migration to discover on-premises VMware VMs, and send VM metadata/performance data to Azure.
+The [Azure Migrate appliance](migrate-appliance.md) is a lightweight appliance used by Azure Migrate:Server Assessment and Server Migration to discover on-premises VMware VMs, send VM metadata/performance data to Azure, and for replication of VMware VMs during agentless migration.
 
 You can set up the Azure Migrate appliance for VMware VM assessment using an OVA template that you download, or using a PowerShell installation script. This article describes how to set up the appliance using the OVA template. If you want to set up the appliance using the script, follow the instructions in [this article](deploy-appliance-script.md).
 

articles/migrate/migrate-appliance-architecture.md

@@ -32,11 +32,26 @@ The appliance has a number of components.
 - **Gateway**: Sends replicated data to Azure. Used only when replicating VMware VMs to Azure using agentless migration.
 - **Auto update service**: Updates appliance components (runs every 24 hours).
 
+
+
 ## Appliance deployment
 
 - The Azure Migrate appliance can be set up using a template (Hyper-V or VMware only) or a PowerShell script installer. [Learn more](deploy-appliance.md#deployment-options) about the options. 
 - Appliance support requirements and deployment prerequisites are summarized in the [appliance support matrix](migrate-appliance.md).
 
+
+## Appliance registration
+
+During appliance setup, you register the appliance with Azure Migrate.During setup and registration the actions summarized in the table occur.
+
+**Action** | **Details** | **Permissions**
+--- | --- | ---
+**Register source providers** | These resources providers are registered in the subscription you choose during appliance setup: Microsoft.OffAzure, Microsoft.Migrate and Microsoft.KeyVault.<br/><br/> Registering a resource provider configures your subscription to work with the resource provider. | To register the resource providers, you need a Contributor or Owner role on the subscription.
+**Create Azure AD app-communication** | Azure Migrate creates an Azure Active Directory (Azure AD) app for communication (authentication and authorization) between the agents running on the appliance, and their respective services running on Azure.<br/><br/> This app does not have privileges to make Azure resource manager calls, or RBAC access on any resource. | You need [these permissions](tutorial-prepare-vmware.md#assign-permissions-to-register-the-appliance) for Azure Migrate to create the app.
+**Create Azure AD apps-Key vault** | This app is created only for agentless migration of VMware VMs to Azure.<br/><br/> It's used exclusively to access the key vault created in the user's subscription for agentless migration.<br/><br/> It has RBAC access on the Azure key vault (created in customer's tenant), when discovery is initiated from the appliance. | You need [these permissions](tutorial-prepare-vmware.md#assign-permissions-to-register-the-appliance) for Azure Migrate to create the app.
+
+
+
 ## Collected data
 
 Data collected by the client for all deployment scenarios is captured fully in the [appliance support matrix](migrate-appliance.md).