Merge pull request #5413 from maddieclayton/deprecation

Add deprecation for PowerShell 3/4 to Profile psm1

Author: markcowl

src/ResourceManager/Profile/ChangeLog.md

@@ -18,6 +18,7 @@
         - Additional information about change #1
 -->
 ## Current Release
+* Added deprecation warning for PowerShell 3 and 4
 * `Add-AzureRmAccount` has been renamed as `Connect-AzureRmAccount`; an alias has been added for the old cmdlet name, and other aliases (`Login-AzAccount` and `Login-AzureRmAccount`) have been redirected to the new cmdlet name.
 * `Remove-AzureRmAccount` has been renamed as `Disconnect-AzureRmAccount`; an alias has been added for the old cmdlet name, and other aliases (`Logout-AzAccount` and `Logout-AzureRmAccount`) have been redirected to the new cmdlet name.
 * Corrected Resource Strings to use Connect-AzureRmAccount instead of Login-AzureRmAccount

tools/AzureRM.Example.psm1

@@ -38,6 +38,10 @@ if ($PSVersionTable.PSVersion.Major -ge 5)
         Register-ArgumentCompleter -CommandName $_.Command -ParameterName $_.Parameter -ScriptBlock $sb
     }
 }
+else
+{
+    %PSVersionDeprecationMessage%
+}
 
 $FilteredCommands = %DEFAULTRGCOMMANDS%
 

tools/UpdateModules.ps1

@@ -67,6 +67,24 @@ function Create-ModulePsm1
      $template = $template -replace "%DATE%", [string](Get-Date)
      $template = $template -replace "%IMPORTED-DEPENDENCIES%", $importedModules
 
+     if ($ModulePath -like "*Profile*")
+     {
+        $WarningMessage = "`"PowerShell version 3 and 4 will no longer be supported starting in May 2018. Please update to the latest version of PowerShell 5.1`""
+        $template = $template -replace "%PSVersionDeprecationMessage%", 
+            "`$SpecialFolderPath = Join-Path -Path ([Environment]::GetFolderPath('ApplicationData')) -ChildPath 'Windows Azure Powershell' `
+            `$DeprecationFile = Join-Path -Path `$SpecialFolderPath -ChildPath 'PSDeprecationWarning.txt' `
+            if (!(Test-Path `$DeprecationFile)) { `
+                Write-Warning $WarningMessage `
+                try { `
+                $WarningMessage | Out-File -FilePath `$DeprecationFile `
+                } catch {} `
+            }"
+     }
+     else
+     {
+         $template = $template -replace "%PSVersionDeprecationMessage%", ""
+     }
+
      $completerCommands = Find-CompleterAttribute -ModuleMetadata $ModuleMetadata -ModulePath $ModulePath -IsRMModule $IsRMModule
      $template = $template -replace "%COMPLETERCOMMANDS%", $completerCommands