Update requirements.psd1 template for PowerShell function apps (#7073)

Author: Francisco-Gamino

src/WebJobs.Script/FileProvisioning/PowerShell/PowerShellFileProvisioner.cs

@@ -62,20 +62,27 @@ private void AddRequirementsFile(string scriptRootPath)
                 string requirementsContent = FileUtility.ReadResourceString(RequirementsPsd1ResourceFileName);
                 string guidance = null;
 
+                bool majorVersionRetrievedSuccessfully = false;
+
                 try
                 {
                     string majorVersion = GetLatestAzModuleMajorVersion();
-
-                    requirementsContent = Regex.Replace(requirementsContent, @"#(\s?)'Az'", "'Az'");
                     requirementsContent = Regex.Replace(requirementsContent, "MAJOR_VERSION", majorVersion);
+
+                    majorVersionRetrievedSuccessfully = true;
                 }
                 catch
                 {
-                    guidance = "Uncomment the next line and replace the MAJOR_VERSION, e.g., 'Az' = '2.*'";
+                    guidance = "Uncomment the next line and replace the MAJOR_VERSION, e.g., 'Az' = '5.*'";
                     _logger.LogDebug($"Failed to get Az module version. Edit the {RequirementsPsd1FileName} file when the powershellgallery.com is accessible.");
                 }
 
-                requirementsContent = Regex.Replace(requirementsContent, "GUIDANCE", guidance ?? string.Empty);
+                if (majorVersionRetrievedSuccessfully)
+                {
+                    guidance = Environment.NewLine + "    # To use the Az module in your function app, please uncomment the line below.";
+                }
+
+                requirementsContent = Regex.Replace(requirementsContent, "GUIDANCE", guidance);
                 File.WriteAllText(requirementsFilePath, requirementsContent);
 
                 _logger.LogDebug($"{RequirementsPsd1FileName} created sucessfully.");

test/WebJobs.Script.Tests/FileProvisioning/TestPowerShellFileProvisioner.cs

@@ -20,7 +20,7 @@ protected override string GetLatestAzModuleMajorVersion()
                 throw new Exception($@"Failed to get module version for 'Az'.");
             }
 
-            return "2";
+            return "5";
         }
     }
 }

test/WebJobs.Script.Tests/Resources/FileProvisioning/PowerShell/requirements_PSGalleryOffline.psd1

@@ -2,6 +2,6 @@
 # See https://aka.ms/functionsmanageddependency for additional information.
 #
 @{
-    # For latest supported version, go to 'https://www.powershellgallery.com/packages/Az'. Uncomment the next line and replace the MAJOR_VERSION, e.g., 'Az' = '2.*'
+    # For latest supported version, go to 'https://www.powershellgallery.com/packages/Az'. Uncomment the next line and replace the MAJOR_VERSION, e.g., 'Az' = '5.*'
     # 'Az' = 'MAJOR_VERSION.*'
 }

test/WebJobs.Script.Tests/Resources/FileProvisioning/PowerShell/requirements_PSGalleryOnline.psd1

@@ -3,5 +3,6 @@
 #
 @{
     # For latest supported version, go to 'https://www.powershellgallery.com/packages/Az'. 
-    'Az' = '2.*'
+    # To use the Az module in your function app, please uncomment the line below.
+    # 'Az' = '5.*'
 }