Merge pull request #42939 from mattbriggs/mdb_1080604_post-deploy

Review PowerShell

Author: PRMerger19

articles/azure-stack/asdk/asdk-post-deploy.md

@@ -13,15 +13,17 @@ ms.workload: na
 pms.tgt_pltfrm: na
 ms.devlang: na
 ms.topic: article
-ms.date: 05/29/2018
+ms.date: 06/04/2018
 ms.author: jeffgilb
 ms.reviewer: misainat
 ---
 
 # Post ASDK installation configuration tasks
-After [installing the ASDK](asdk-install.md), there are a few recommended post-installation configuration changes be made. 
 
-## Install Azure Stack PowerShell 
+After [installing the Azure Stack Development Kit (ASDK)](asdk-install.md), you will need to make a some recommended post-installation configuration changes.
+
+## Install Azure Stack PowerShell
+
 Azure Stack compatible Azure PowerShell modules are required to work with Azure Stack.
 
 PowerShell commands for Azure Stack are installed through the PowerShell Gallery. To register the PSGallery repository, open an elevated PowerShell session and run the following command:
@@ -32,9 +34,9 @@ Set-PSRepository `
   -InstallationPolicy Trusted
 ```
 
- Azure Stack compatible AzureRM modules are installed through API version profiles. Azure Stack requires the 2017-03-09-profile API version profile, which is available by installing the AzureRM.Bootstrapper module. 
- 
- You can install the latest Azure Stack PowerShell module with or without internet connectivity to the ASDK host computer:
+You can use API version profiles  to specify Azure Stack compatible AzureRM modules.  API version profiles provide a way to manage version differences between Azure and Azure Stack. An API version profile is a set of AzureRM PowerShell modules with specific API versions. The **AzureRM.Bootstrapper** module that is available through the PowerShell Gallery provides PowerShell cmdlets that are required to work with API version profiles.
+
+You can install the latest Azure Stack PowerShell module with or without Internet connectivity to the ASDK host computer:
 
 > [!IMPORTANT]
 > Before installing the required version, make sure that you [uninstall any existing Azure PowerShell modules](.\.\azure-stack-powershell-install.md#uninstall-existing-versions-of-powershell).
@@ -50,11 +52,13 @@ Set-PSRepository `
   Use-AzureRmProfile `
     -Profile 2017-03-09-profile -Force
 
-  Install-Module `
-    -Name AzureStack `
-    # If you are not running Azure Stack with update 1804 or greater, change the requiredversion parameter value to 1.2.11. 
-    -RequiredVersion 1.3.0
+  # Install Module Version 1.3.0 if Azure Stack is running 1804 at a minimum 
+  Install-Module -Name AzureStack -RequiredVersion 1.3.0 
+
+  # Install Module Version 1.2.11 if Azure Stack is running a lower version than 1804 
+  Install-Module -Name AzureStack -RequiredVersion 1.2.11 
   ```
+
   If the installation is successful, the AzureRM and AzureStack modules are displayed in the output.
 
 - **Without an internet connection** from the ASDK host computer. In a disconnected scenario, you must first download the PowerShell modules to a machine that has internet connectivity using the following PowerShell commands:
@@ -79,9 +83,10 @@ Set-PSRepository `
     # If you are not running Azure Stack with update 1804 or greater, change the requiredversion parameter value to 1.2.11. 
     -RequiredVersion 1.3.0
   ```
+
   Next, copy the downloaded packages to the ASDK computer and register the location as the default repository and install the AzureRM and AzureStack modules from this repository:
 
-    ```PowerShell
+    ```PowerShell  
     $SourceLocation = "<Location on the development kit that contains the PowerShell packages>"
     $RepoName = "MyNuGetSource"
 
@@ -98,6 +103,7 @@ Set-PSRepository `
     ```
 
 ## Download the Azure Stack tools
+
 [AzureStack-Tools](https://github.com/Azure/AzureStack-Tools) is a GitHub repository that hosts PowerShell modules for managing and deploying resources to Azure Stack. To obtain these tools, clone the GitHub repository or download the AzureStack-Tools folder by running the following script:
 
   ```PowerShell
@@ -122,7 +128,7 @@ Set-PSRepository `
 ## Validate the ASDK installation
 To ensure that your ASDK deployment was successful, you can use the Test-AzureStack cmdlet by following these steps:
 
-1. Log in as AzureStack\CloudAdmin on the ASDK host computer.
+1. Log in as AzureStack\AzureStackAdmin on the ASDK host computer.
 2. Open PowerShell as an administrator (not PowerShell ISE).
 3. Run: `Enter-PSSession -ComputerName AzS-ERCS01 -ConfigurationName PrivilegedEndpoint`
 4. Run: `Test-AzureStack`