[Resources] Update Publish-AzBicepModule to include new optional parameter -DocumentationUri (#21122)

* Added new -Documentationuri for bicep publish command

* Updated ChangeLog.md

* Updated changelog

Author: bhsubra

src/Resources/ResourceManager/Implementation/Bicep/PublishAzureBicepModuleCmdlet.cs

@@ -30,12 +30,15 @@ public class PublishAzureBicepModuleCmdlet : AzureRMCmdlet
         [ValidateNotNullOrEmpty]
         public string Target { get; set; }
 
+        [Parameter(Mandatory = false, HelpMessage = "Documentation uri of the Bicep module.")]
+        public string DocumentationUri { get; set; }
+
         [Parameter(Mandatory = false, HelpMessage="Indicates that this cmdlet returns a boolean result. By default, this cmdlet does not generate any output.")]
         public SwitchParameter PassThru { get; set; }
 
         public override void ExecuteCmdlet()
         {
-            BicepUtility.PublishFile(this.TryResolvePath(this.FilePath), this.Target, this.WriteVerbose, this.WriteWarning);
+            BicepUtility.PublishFile(this.TryResolvePath(this.FilePath), this.Target, this.DocumentationUri, this.WriteVerbose, this.WriteWarning);
 
             if (this.PassThru.IsPresent)
             {

src/Resources/ResourceManager/Utilities/BicepUtility.cs

@@ -30,6 +30,8 @@ internal static class BicepUtility
 
         private const string MinimalVersionRequirementForBicepPublish = "0.4.1008";
 
+        private const string MinimalVersionRequirementForBicepPublishWithOptionalDocumentationUriParameter = "0.14.46";
+
         public delegate void OutputCallback(string msg);
 
         public static bool IsBicepFile(string templateFilePath) =>
@@ -56,14 +58,26 @@ public static string BuildFile(string bicepTemplateFilePath, OutputCallback writ
             return buildResultPath;
         }
 
-        public static void PublishFile(string bicepFilePath, string target, OutputCallback writeVerbose = null, OutputCallback writeWarning = null)
+        public static void PublishFile(string bicepFilePath, string target, string documentationUri = null, OutputCallback writeVerbose = null, OutputCallback writeWarning = null)
         {
             if (!FileUtilities.DataStore.FileExists(bicepFilePath))
             {
                 throw new AzPSArgumentException(Properties.Resources.InvalidBicepFilePath, "File");
             }
 
-            RunBicepCommand($"bicep publish '{bicepFilePath}' --target '{target}'", MinimalVersionRequirementForBicepPublish, writeVerbose, writeWarning);
+            string bicepPublishCommand;
+
+            if (!string.IsNullOrWhiteSpace(documentationUri))
+            {
+                CheckMinimalVersionRequirement(MinimalVersionRequirementForBicepPublishWithOptionalDocumentationUriParameter);
+                bicepPublishCommand = $"bicep publish '{bicepFilePath}' --target '{target}' --documentationUri '{documentationUri}'";
+            }
+            else
+            {
+                bicepPublishCommand = $"bicep publish '{bicepFilePath}' --target '{target}'";
+            }
+
+            RunBicepCommand(bicepPublishCommand, MinimalVersionRequirementForBicepPublish, writeVerbose, writeWarning);
         }
 
         private static void CheckBicepExecutable()

src/Resources/Resources/ChangeLog.md

@@ -23,6 +23,7 @@
 
 ## Version 6.5.3
 * Updated behavior of Get-AzPolicyDefinition which previously returned all definitions when -Id was provided with a nonexistent policy definition id. Fixed to correctly throw a 404 exception in this case.
+* Updated `Publish-AzBicepModule` to include new optional parameter `-DocumentationUri`
 
 ## Version 6.5.2
 * Fixed query issue when objectId in assignment is empty for `Get-DenyAssignment`

src/Resources/Resources/help/Publish-AzBicepModule.md

@@ -13,7 +13,7 @@ Publishes a Bicep file to a registry.
 ## SYNTAX
 
 ```
-Publish-AzBicepModule -FilePath <String> -Target <String> [-PassThru]
+Publish-AzBicepModule -FilePath <String> -Target <String> -DocumentationUri <String> [-PassThru]
  [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
@@ -91,6 +91,21 @@ Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
 ```
 
+### -DocumentationUri
+The documentation uri of the Bicep module..
+
+```yaml
+Type: System.String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: True (ByPropertyName)
+Accept wildcard characters: False
+```
+
 ### -Confirm
 Prompts you for confirmation before running the cmdlet.