Migrate Compute from generation to main (#20788)

* Move Compute to main

* Update ChangeLog.md

---------

Co-authored-by: Yeming Liu <[email protected]>

Author: azure-powershell-bot

src/Compute/Compute.Autorest/Az.Compute.psm1

@@ -33,7 +33,7 @@
   }
 
   if(-not $accountsModule) {
-    Write-Error "`nThis module requires $accountsName version 2.7.5 or greater. For installation instructions, please see: https://learn.microsoft.com/powershell/azure/install-az-ps" -ErrorAction Stop
+    Write-Error "`nThis module requires $accountsName version 2.7.5 or greater. For installation instructions, please see: https://docs.microsoft.com/powershell/azure/install-az-ps" -ErrorAction Stop
   } elseif (($accountsModule.Version -lt [System.Version]'2.7.5') -and (-not $localAccounts)) {
     Write-Error "`nThis module requires $accountsName version 2.7.5 or greater. An earlier version of Az.Accounts is imported in the current PowerShell session. If you are running test, please try to add the switch '-RegenerateSupportModule' when executing 'test-module.ps1'. Otherwise please open a new PowerShell session and import this module again.`nAdditionally, this error could indicate that multiple incompatible versions of Azure PowerShell modules are installed on your system. For troubleshooting information, please see: https://aka.ms/azps-version-error" -ErrorAction Stop
   }

src/Compute/Compute.Autorest/custom/README.md

@@ -32,7 +32,7 @@ These provide functionality to our HTTP pipeline and other useful features. In s
 ### Attributes
 For processing the cmdlets, we've created some additional attributes:
 - `Microsoft.Azure.PowerShell.Cmdlets.Compute.DescriptionAttribute`
-  - Used in C# cmdlets to provide a high-level description of the cmdlet. This is propagated to reference documentation via [help comments](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_comment_based_help) in the exported scripts.
+  - Used in C# cmdlets to provide a high-level description of the cmdlet. This is propagated to reference documentation via [help comments](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_comment_based_help) in the exported scripts.
 - `Microsoft.Azure.PowerShell.Cmdlets.Compute.DoNotExportAttribute`
   - Used in C# and script cmdlets to suppress creating an exported cmdlet at build-time. These cmdlets will *not be exposed* by `Az.Compute`.
 - `Microsoft.Azure.PowerShell.Cmdlets.Compute.InternalExportAttribute`

src/Compute/Compute.Autorest/custom/Set-AzVMRunCommand_ScriptLocalPath.ps1

@@ -180,7 +180,50 @@ function Set-AzVMRunCommand_ScriptLocalPath {
         if ($PSBoundParameters.ContainsKey("ScriptLocalPath"))
         {
             # Read Local File and add 
-            $script = (Get-Content -Path $ScriptLocalPath) -join ";"
+            $script = ""
+            if ((Get-ChildItem $scriptLocalPath | Select-Object Extension).Extension -eq ".sh"){
+                foreach ($line in Get-Content -Path $scriptLocalPath){
+                    $words = $line.trim().split()
+                    $commentFound = $false
+                    foreach ($word in $words){
+                        if ($word[0] -eq "#" -and $commentFound -eq $false){
+                            $commentFound = $true
+                            $script += "``" + $word + " "
+                        }
+                        else{
+                            $script += $word + " "
+                        }
+                    }
+                    $script = $script.trim()
+                    #close 
+                    if ($commentFound){
+                    $script += "``"
+                    }
+                    $script += ";"
+                }
+            }
+            else{
+                foreach ($line in Get-Content -Path $scriptLocalPath){
+                    $words = $line.trim().split()
+                    $commentFound = $false
+                    foreach ($word in $words){
+                        if ($word[0] -eq "#" -and $commentFound -eq $false){
+                            $commentFound = $true
+                            $script += "<" + $word + " "
+                        }
+                        else{
+                            $script += $word + " "
+                        }
+                    }
+                    $script = $script.trim()
+                    #close 
+                    if ($commentFound){
+                        $script += "#>"
+                    }
+                    $script += ";"
+                }
+            }
+            
             $PSBoundParameters.Add("SourceScript", $script)
             # If necessary, remove the -ParameterA parameter from the dictionary of bound parameters
             $null = $PSBoundParameters.Remove("ScriptLocalPath")

src/Compute/Compute.Autorest/custom/Set-AzVmssVMRunCommand_ScriptLocalPath.ps1

@@ -185,8 +185,50 @@ function Set-AzVmssVMRunCommand_ScriptLocalPath {
     process {
         if ($PSBoundParameters.ContainsKey("ScriptLocalPath"))
         {
-            # Read Local File and add 
-            $script = (Get-Content -Path $ScriptLocalPath) -join ";"
+             # Read Local File and add 
+             $script = ""
+             if ((Get-ChildItem $scriptLocalPath | Select-Object Extension).Extension -eq ".sh"){
+                 foreach ($line in Get-Content -Path $scriptLocalPath){
+                     $words = $line.trim().split()
+                     $commentFound = $false
+                     foreach ($word in $words){
+                         if ($word[0] -eq "#" -and $commentFound -eq $false){
+                             $commentFound = $true
+                             $script += "``" + $word + " "
+                         }
+                         else{
+                             $script += $word + " "
+                         }
+                     }
+                     $script = $script.trim()
+                     #close 
+                     if ($commentFound){
+                     $script += "``"
+                     }
+                     $script += ";"
+                 }
+             }
+             else{
+                 foreach ($line in Get-Content -Path $scriptLocalPath){
+                     $words = $line.trim().split()
+                     $commentFound = $false
+                     foreach ($word in $words){
+                         if ($word[0] -eq "#" -and $commentFound -eq $false){
+                             $commentFound = $true
+                             $script += "<" + $word + " "
+                         }
+                         else{
+                             $script += $word + " "
+                         }
+                     }
+                     $script = $script.trim()
+                     #close 
+                     if ($commentFound){
+                         $script += "#>"
+                     }
+                     $script += ";"
+                 }
+            }
             $PSBoundParameters.Add("SourceScript", $script)
             # If necessary, remove the -ParameterA parameter from the dictionary of bound parameters
             $null = $PSBoundParameters.Remove("ScriptLocalPath")

src/Compute/Compute.Autorest/docs/README.md

@@ -8,4 +8,4 @@ This directory contains the documentation of the cmdlets for the `Az.Compute` mo
 - Packaged: yes
 
 ## Details
-The process of documentation generation loads `Az.Compute` and analyzes the exported cmdlets from the module. It recognizes the [help comments](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_comment_based_help) that are generated into the scripts in the `..\exports` folder. Additionally, when writing custom cmdlets in the `..\custom` folder, you can use the help comments syntax, which decorate the exported scripts at build-time. The documentation examples are taken from the `..\examples` folder.
+The process of documentation generation loads `Az.Compute` and analyzes the exported cmdlets from the module. It recognizes the [help comments](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_comment_based_help) that are generated into the scripts in the `..\exports` folder. Additionally, when writing custom cmdlets in the `..\custom` folder, you can use the help comments syntax, which decorate the exported scripts at build-time. The documentation examples are taken from the `..\examples` folder.

src/Compute/Compute.Autorest/exports/README.md

@@ -1,5 +1,5 @@
 # Exports
-This directory contains the cmdlets *exported by* `Az.Compute`. No other cmdlets in this repository are directly exported. What that means is the `Az.Compute` module will run [Export-ModuleMember](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/export-modulemember) on the cmldets in this directory. The cmdlets in this directory are generated at **build-time**. Do not put any custom code, files, cmdlets, etc. into this directory. Please use `..\custom` for all custom implementation.
+This directory contains the cmdlets *exported by* `Az.Compute`. No other cmdlets in this repository are directly exported. What that means is the `Az.Compute` module will run [Export-ModuleMember](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/export-modulemember) on the cmldets in this directory. The cmdlets in this directory are generated at **build-time**. Do not put any custom code, files, cmdlets, etc. into this directory. Please use `..\custom` for all custom implementation.
 
 ## Info
 - Modifiable: no

src/Compute/Compute.Autorest/generate-info.json

@@ -1,8 +1,8 @@
 {
-  "autorest_core": "3.9.3",
-  "swagger_commit": "c583b05741fadfdca116be3b9ccb1c4be8a73258",
+  "autorest_modelerfour": "4.15.414",
   "autorest_powershell": "3.0.498",
+  "autorest_core": "3.9.4",
   "autorest": "`-- (empty)",
-  "node": "v14.15.5",
-  "autorest_modelerfour": "4.15.414"
+  "swagger_commit": "18e83e24c36eed85a240103b476de0220ace7f84",
+  "node": "v14.15.5"
 }

src/Compute/Compute.Autorest/how-to.md

@@ -14,7 +14,7 @@ To generate documentation, the process is now integrated into the `build-module.
 To test the cmdlets, we use [Pester](https://github.com/pester/Pester). Tests scripts (`.ps1`) should be added to the `test` folder. To execute the Pester tests, run the `test-module.ps1` script. This will run all tests in `playback` mode within the `test` folder. To read more about testing cmdlets, look at the [README.md](examples/README.md) in the `examples` folder.
 
 ## Packing `Az.Compute`
-To pack `Az.Compute` for distribution, run the `pack-module.ps1` script. This will take the contents of multiple directories and certain root-folder files to create a `.nupkg`. The structure of the `.nupkg` is created so it can be loaded part of a [PSRepository](https://learn.microsoft.com/powershell/module/powershellget/register-psrepository). Additionally, this package is in a format for distribution to the [PSGallery](https://www.powershellgallery.com/). For signing an Azure module, please contact the [Azure PowerShell](https://github.com/Azure/azure-powershell) team.
+To pack `Az.Compute` for distribution, run the `pack-module.ps1` script. This will take the contents of multiple directories and certain root-folder files to create a `.nupkg`. The structure of the `.nupkg` is created so it can be loaded part of a [PSRepository](https://docs.microsoft.com/powershell/module/powershellget/register-psrepository). Additionally, this package is in a format for distribution to the [PSGallery](https://www.powershellgallery.com/). For signing an Azure module, please contact the [Azure PowerShell](https://github.com/Azure/azure-powershell) team.
 
 ## Module Script Details
 There are multiple scripts created for performing different actions for developing `Az.Compute`.

src/Compute/Compute.Autorest/internal/README.md

@@ -8,7 +8,7 @@ This directory contains a module to handle *internal only* cmdlets. Cmdlets that
 - Packaged: yes
 
 ## Details
-The `Az.Compute.internal.psm1` file is generated to this folder. This module file handles the hidden cmdlets. These cmdlets will not be exported by `Az.Compute`. Instead, this sub-module is imported by the `..\custom\Az.Compute.custom.psm1` module, allowing you to use hidden cmdlets in your custom, exposed cmdlets. To call these cmdlets in your custom scripts, simply use [module-qualified calls](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_command_precedence?view=powershell-6#qualified-names). For example, `Az.Compute.internal\Get-Example` would call an internal cmdlet named `Get-Example`.
+The `Az.Compute.internal.psm1` file is generated to this folder. This module file handles the hidden cmdlets. These cmdlets will not be exported by `Az.Compute`. Instead, this sub-module is imported by the `..\custom\Az.Compute.custom.psm1` module, allowing you to use hidden cmdlets in your custom, exposed cmdlets. To call these cmdlets in your custom scripts, simply use [module-qualified calls](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_command_precedence?view=powershell-6#qualified-names). For example, `Az.Compute.internal\Get-Example` would call an internal cmdlet named `Get-Example`.
 
 ## Purpose
 This allows you to include REST specifications for services that you *do not wish to expose from your module*, but simply want to call within custom cmdlets. For example, if you want to make a custom cmdlet that uses `Storage` services, you could include a simplified `Storage` REST specification that has only the operations you need. When you run the generator and build this module, note the generated `Storage` cmdlets. Then, in your readme configuration, use [cmdlet hiding](https://github.com/Azure/autorest/blob/master/docs/powershell/options.md#cmdlet-hiding-exportation-suppression) on the `Storage` cmdlets and they will *only be exposed to the custom cmdlets* you want to write, and not be exported as part of `Az.Compute`.

src/Compute/Compute/Az.Compute.psd1

@@ -3,7 +3,7 @@
 #
 # Generated by: Microsoft Corporation
 #
-# Generated on: 1/6/2023
+# Generated on: 1/30/2023
 #
 
 @{
@@ -220,7 +220,7 @@ PrivateData = @{
     PSData = @{
 
         # Tags applied to this module. These help with module discovery in online galleries.
-        Tags = 'Azure','ResourceManager','ARM','Compute','IAAS','VM','VirtualMachine'
+        Tags = 'Azure', 'ResourceManager', 'ARM', 'Compute', 'IAAS', 'VM', 'VirtualMachine'
 
         # A URL to the license for this module.
         LicenseUri = 'https://aka.ms/azps-license'
@@ -248,7 +248,7 @@ PrivateData = @{
 
     } # End of PSData hashtable
 
- } # End of PrivateData hashtable
+} # End of PrivateData hashtable
 
 # HelpInfo URI of this module
 # HelpInfoURI = ''