Updated Az upgrade target from 4.6.1 to 4.8.0 (#64)

* Updated Az upgrade target to 4.7.0

* Fixed typo

* Updated Az spec to 4.8.0

* Updated spec unit test expected command counts

Author: keithbabinec

.github/CONTRIBUTING.md

@@ -41,7 +41,7 @@ We recommend that you use [Visual Studio Code](https://docs.microsoft.com/dotnet
 
 ### Writing code
 
-> **IMPORTANT:** If you are writting code to submit a feature request, ensure that you have submited a feature request before and it has been accepted.
+> **IMPORTANT:** If you are writing code to submit a feature request, ensure that you have submitted a feature request before and it has been accepted.
 
 - Launch VSCode and open the `powershell-module` folder instead of each individual file.
   Alternatively, from a prompt, navigate to `<your_path>\azure-powershell-migration\powershell-module` directory and type `code .`
@@ -56,7 +56,7 @@ We recommend that you use [Visual Studio Code](https://docs.microsoft.com/dotnet
 
 Further reading:
 
-- [Writting tests with Pester](https://pester.dev/docs/quick-start#creating-a-pester-test)
+- [Writing tests with Pester](https://pester.dev/docs/quick-start#creating-a-pester-test)
 - [Introduction to Pester](https://dev.to/omiossec/unit-testing-in-powershell-introduction-to-pester-1de7)
 - [Pester source code](https://github.com/pester/Pester/tree/4.10.1)
 

docs/quickstart-migrate-azurerm-to-az-automatically.md

@@ -44,12 +44,12 @@ points that require changes when moving from AzureRM to the Az PowerShell cmdlet
 
 ```powershell
 #  Generate an upgrade plan for the specified PowerShell script and save it to a variable.
-$Plan = New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 4.6.1 -FilePath 'C:\Scripts\my-azure-script.ps1'
+$Plan = New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 4.8.0 -FilePath 'C:\Scripts\my-azure-script.ps1'
 ```
 
 ```powershell
 # Generate an upgrade plan for all the scripts and module files in the specified folder and save it to a variable.
-$Plan = New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 4.6.1 -DirectoryPath 'C:\Scripts'
+$Plan = New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 4.8.0 -DirectoryPath 'C:\Scripts'
 ```
 
 Review the results of the upgrade plan.
@@ -108,7 +108,7 @@ $Results | Where-Object UpgradeResult -ne UpgradeCompleted | Format-List
   during upgrade plan generation, a warning is returned.
 * File I/O operations use default encoding. Unusual file encoding situations may cause problems.
 * AzureRM cmdlets passed as arguments to Pester unit test mock statements aren't detected.
-* Currently, only Az PowerShell module version 4.6.1 is supported as a target.
+* Currently, only Az PowerShell module version 4.8.0 is supported as a target.
 
 ## Next steps
 

powershell-module/Az.Tools.Migration/Functions/Public/Get-AzUpgradeAliasSpec.ps1

@@ -11,8 +11,8 @@ function Get-AzUpgradeAliasSpec
         Specify the version of the module to import command aliases from.
 
     .EXAMPLE
-        PS C:\> Get-AzUpgradeAliasSpec -ModuleVersion "4.6.1"
-        Returns the cmdlet alias mappings table for Az 4.6.1.
+        PS C:\> Get-AzUpgradeAliasSpec -ModuleVersion "4.8.0"
+        Returns the cmdlet alias mappings table for Az 4.8.0.
     #>
     [CmdletBinding()]
     Param

powershell-module/Az.Tools.Migration/Functions/Public/Invoke-AzUpgradeModulePlan.ps1

@@ -23,7 +23,7 @@ function Invoke-AzUpgradeModulePlan
         The following example invokes the upgrade plan for a PowerShell module named "myModule" and saves the updated file contents into new files (leaving original files unmodified).
 
         # step 1: generate a plan and save it to a variable.
-        $plan = New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 4.6.1 -DirectoryPath 'C:\Scripts\myModule'
+        $plan = New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 4.8.0 -DirectoryPath 'C:\Scripts\myModule'
 
         # step 2: write the plan to the console to review the upgrade steps, warnings, and errors.
         $plan
@@ -38,7 +38,7 @@ function Invoke-AzUpgradeModulePlan
         The following example invokes the upgrade plan for a PowerShell module named "myModule" and modifies the existing files in place.
 
         # step 1: generate a plan and save it to a variable.
-        $plan = New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 4.6.1 -DirectoryPath 'C:\Scripts\myModule'
+        $plan = New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 4.8.0 -DirectoryPath 'C:\Scripts\myModule'
 
         # step 2: write the plan to the console to review the upgrade steps, warnings, and errors.
         $plan

powershell-module/Az.Tools.Migration/Functions/Public/New-AzUpgradeModulePlan.ps1

@@ -11,7 +11,7 @@ function New-AzUpgradeModulePlan
         Specifies the AzureRM module version used in your existing PowerShell scripts(s) or modules.
 
     .PARAMETER ToAzVersion
-        Specifies the Az module version to upgrade to. Currently, only Az version 4.6.1 is supported.
+        Specifies the Az module version to upgrade to. Currently, only Az version 4.8.0 is supported.
 
     .PARAMETER FilePath
         Specifies the path to a single PowerShell file.
@@ -34,32 +34,32 @@ function New-AzUpgradeModulePlan
     .EXAMPLE
         The following example generates a new Az module upgrade plan for the script file 'C:\Scripts\my-azure-script.ps1'.
 
-        New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 4.6.1 -FilePath 'C:\Scripts\my-azure-script.ps1'
+        New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 4.8.0 -FilePath 'C:\Scripts\my-azure-script.ps1'
 
     .EXAMPLE
         The following example generates a new Az module upgrade plan for the script and module files located under C:\Scripts.
 
-        New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 4.6.1 -DirectoryPath 'C:\Scripts'
+        New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 4.8.0 -DirectoryPath 'C:\Scripts'
 
     .EXAMPLE
         The following example generates a new Az module upgrade plan for the script and module files under C:\Scripts.
 
         $references = Find-AzUpgradeCommandReference -DirectoryPath 'C:\Scripts' -AzureRmVersion '6.13.1'
-        New-AzUpgradeModulePlan -ToAzVersion 4.6.1 -AzureRmCmdReference $references
+        New-AzUpgradeModulePlan -ToAzVersion 4.8.0 -AzureRmCmdReference $references
 
     .EXAMPLE
         The following example generates a new Az module upgrade plan for the script and module files under several directories.
         Module specs are pre-loaded here to avoid re-loading the spec each time a plan is generated.
 
         # pre-load specifications
         $armSpec = Get-AzUpgradeCmdletSpec -ModuleName "AzureRM" -ModuleVersion "6.13.1"
-        $azSpec = Get-AzUpgradeCmdletSpec -ModuleName "Az" -ModuleVersion "4.6.1"
-        $azAliases = Get-AzUpgradeAliasSpec -ModuleVersion "4.6.1"
+        $azSpec = Get-AzUpgradeCmdletSpec -ModuleName "Az" -ModuleVersion "4.8.0"
+        $azAliases = Get-AzUpgradeAliasSpec -ModuleVersion "4.8.0"
 
         # execute a batch of module upgrades
-        $plan1 = New-AzUpgradeModulePlan -DirectoryPath 'C:\Scripts1' -FromAzureRmVersion '6.13.1' -ToAzVersion 4.6.1 -AzureRmModuleSpec $armSpec -AzModuleSpec $azSpec -AzAliasMappingSpec $azAliases
-        $plan2 = New-AzUpgradeModulePlan -DirectoryPath 'C:\Scripts2' -FromAzureRmVersion '6.13.1' -ToAzVersion 4.6.1 -AzureRmModuleSpec $armSpec -AzModuleSpec $azSpec -AzAliasMappingSpec $azAliases
-        $plan3 = New-AzUpgradeModulePlan -DirectoryPath 'C:\Scripts3' -FromAzureRmVersion '6.13.1' -ToAzVersion 4.6.1 -AzureRmModuleSpec $armSpec -AzModuleSpec $azSpec -AzAliasMappingSpec $azAliases
+        $plan1 = New-AzUpgradeModulePlan -DirectoryPath 'C:\Scripts1' -FromAzureRmVersion '6.13.1' -ToAzVersion '4.8.0' -AzureRmModuleSpec $armSpec -AzModuleSpec $azSpec -AzAliasMappingSpec $azAliases
+        $plan2 = New-AzUpgradeModulePlan -DirectoryPath 'C:\Scripts2' -FromAzureRmVersion '6.13.1' -ToAzVersion '4.8.0' -AzureRmModuleSpec $armSpec -AzModuleSpec $azSpec -AzAliasMappingSpec $azAliases
+        $plan3 = New-AzUpgradeModulePlan -DirectoryPath 'C:\Scripts3' -FromAzureRmVersion '6.13.1' -ToAzVersion '4.8.0' -AzureRmModuleSpec $armSpec -AzModuleSpec $azSpec -AzAliasMappingSpec $azAliases
     #>
     [CmdletBinding()]
     Param
@@ -103,7 +103,7 @@ function New-AzUpgradeModulePlan
             Mandatory=$true,
             HelpMessage='Specify the Az module version to upgrade to.')]
         [System.String]
-        [ValidateSet('4.6.1')]
+        [ValidateSet('4.8.0')]
         $ToAzVersion,
 
         [Parameter(Mandatory=$false)]
@@ -319,7 +319,7 @@ function New-AzUpgradeModulePlan
                     $paramError.StartOffset = $rmParam.StartOffset
                     $paramError.SourceCommandParameter = $rmParam
                     $paramError.Location = $rmParam.Location
-                    $paramError.PlanResultReason = "Parameter was not found in $resolvedCommandName or it's aliases."
+                    $paramError.PlanResultReason = "Parameter was not found in $resolvedCommandName or its aliases."
                     $paramError.PlanResult = [PlanResultReasonCode]::ErrorParameterNotFound
                     $paramError.PlanSeverity = [DiagnosticSeverity]::Error