[Eng] Remove 'ProgressAction' while build autorest modules (Azure#27394)

Author: VeryEarly

tools/BuildScripts/AdaptAutorestModule.ps1

@@ -182,6 +182,8 @@ try{
             [string]$SubModuleNameTrimmed
         )
 
+        $helpMarkDownScriptPath = Join-Path $RepoRoot 'tools' 'BuildScripts' 'HelpMarkDown.psm1'
+        Import-Module $helpMarkDownScriptPath
         $resolveScriptPath = Join-Path $RepoRoot 'tools' 'ResolveTools' 'Resolve-Psd1.ps1'
         $artifacts = Join-Path $RepoRoot 'artifacts'
         $artifactAccountPsd1Path = Join-Path $artifacts 'Debug' "Az.Accounts" "Az.Accounts.psd1"
@@ -219,6 +221,8 @@ try{
                 Write-Host "Redundant help markdown detected, removing $helpFile ..."
                 Remove-Item $helpFile.FullName -Force
             }
+            Write-Host "Removing ProgressAction parameter from $helpFile ..."
+            Remove-CommonParameterFromMarkdown -Path $helpFile.FullName -ParameterName 'ProgressAction'
         }
         & $resolveScriptPath -ModuleName $ModuleRootName -ArtifactFolder $artifacts -Psd1Folder $parentModulePath
     } -ArgumentList $RepoRoot, $ModuleRootName, $parentModuleName, $SubModuleName, $subModuleNameTrimmed

tools/BuildScripts/HelpMarkDown.psm1

@@ -0,0 +1,46 @@
+# Copied from https://gist.github.com/wyunchi-ms/098996d35e1f98388837fa31aaaa6f62
+function Remove-CommonParameterFromMarkdown {
+    <#
+        .SYNOPSIS
+            Remove a PlatyPS generated parameter block.
+        .DESCRIPTION
+            Removes parameter block for the provided parameter name from the markdown file provided.
+    #>
+    param(
+        [Parameter(Mandatory)]
+        [string[]]
+        $Path,
+
+        [Parameter(Mandatory = $false)]
+        [string[]]
+        $ParameterName = @('ProgressAction')
+    )
+    $ErrorActionPreference = 'Stop'
+    foreach ($p in $Path) {
+        $content = (Get-Content -Path $p -Raw).TrimEnd()
+        $updateFile = $false
+        foreach ($param in $ParameterName) {
+            if (-not ($Param.StartsWith('-'))) {
+                $param = "-$($param)"
+            }
+            # Remove the parameter block
+            $pattern = "(?m)^### $param\r?\n[\S\s]*?(?=#{2,3}?)"
+            $newContent = $content -replace $pattern, ''
+            # Remove the parameter from the syntax block
+            $pattern = " \[$param\s?.*?]"
+            $newContent = $newContent -replace $pattern, ''
+            if ($null -ne (Compare-Object -ReferenceObject $content -DifferenceObject $newContent)) {
+                Write-Verbose "Added $param to $p"
+                # Update file content
+                $content = $newContent
+                $updateFile = $true
+            }
+        }
+        # Save file if content has changed
+        if ($updateFile) {
+            $newContent | Out-File -Encoding utf8 -FilePath $p
+            Write-Verbose "Updated file: $p"
+        }
+    }
+    return
+}