[PS] migrate ImageBuilder module to autorest v4 (#27647)

Author: JoyerJin

src/ImageBuilder/ImageBuilder.Autorest/Properties/AssemblyInfo.cs

@@ -0,0 +1,29 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the Apache License, Version 2.0 (the ""License"");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an ""AS IS"" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// Code generated by Microsoft (R) AutoRest Code Generator.Changes may cause incorrect behavior and will be lost if the code
+// is regenerated.
+
+using System;
+using System.Reflection;
+using System.Runtime.CompilerServices;
+using System.Runtime.InteropServices;
+
+[assembly: System.Reflection.AssemblyCompanyAttribute("Microsoft")]
+[assembly: System.Reflection.AssemblyCopyrightAttribute("Copyright © Microsoft")]
+[assembly: System.Reflection.AssemblyProductAttribute("Microsoft Azure PowerShell")]
+[assembly: System.Reflection.AssemblyTitleAttribute("Microsoft Azure PowerShell - ImageBuilder")]
+[assembly: System.Reflection.AssemblyFileVersionAttribute("0.4.2")]
+[assembly: System.Reflection.AssemblyVersionAttribute("0.4.2")]
+[assembly: System.Runtime.InteropServices.ComVisibleAttribute(false)]
+[assembly: System.CLSCompliantAttribute(false)]
+
+
+

src/ImageBuilder/ImageBuilder.Autorest/README.md

@@ -58,39 +58,53 @@ directive:
   # 1. Remove the unexpanded parameter set
   # 2. For New-* cmdlets, ViaIdentity is not required, so CreateViaIdentityExpanded is removed as well
   - where:
-      variant: ^Create$|^CreateViaIdentity$|^CreateViaIdentityExpanded$
+      variant: ^(Create)(?!.*?(Expanded|JsonFilePath|JsonString))
     remove: true
-  # Remove the set-* cmdlet
   - where:
-      verb: Set
+      variant: ^CreateViaIdentityExpanded$
     remove: true
-
-  # To remove non-expanded update variants:
+  # Remove the set-* cmdlet
   - where:
-      variant: ^Update(?!.*?Expanded)
+      verb: Set
     remove: true
 
-  # 1. Field 'identity' is required => IdentityType and IdentityUserAssignedIdentity are required
-  # 2. Hide IdentityType as only 'UserAssigned' is valid value so far
-  # 3. Wrap UserAssignedIdentity with UserAssignedIdentityId to simplify customer's input 
-  # 4. Field 'properties' is required => Source, Customize and Distribute are required
-  # Rename IdentityUserAssignedIdentity to UserAssignedIdentity
-  - where:
-      parameter-name: IdentityUserAssignedIdentity
-    set:
-      parameter-name: UserAssignedIdentity
-
   # Rename *-AzImageBuildVirtualMachineImage(.*) -> *-AzImageBuild(.*)
   - where:
       subject: (.*)Image(.*)
     set:
       subject: $2
 
+  # Add required for template
+  # - from: swagger-document
+  #   where: $.definitions.ImageTemplate
+  #   transform: $['required'] = ["identity","properties"]
+  # - from: swagger-document
+  #   where: $.definitions.ImageTemplateProperties
+  #   transform: $['required'] = ["source","distribute","customize"]
+  # Customize New-AzImageBuilderTemplate, remove parameter EnableSystemAssignedIdentity
   - where:
       subject: Template
       variant: ^CreateExpanded$
     hide: true
 
+  # To remove update for Trigger since there is no properties
+  - where:
+      subject: Trigger
+      verb: Update
+    remove: true
+  # Remove Update [Update template not support](https://learn.microsoft.com/en-us/azure/virtual-machines/linux/image-builder-troubleshoot#update-or-upgrade-of-image-templates-is-currently-not-supported)
+  - where:
+      subject: Template
+      verb: Update
+    remove: true
+  
+  # Rename JsonTemplatePath -> JsonFilePath and keep JsonTemplatePath as alias in New-AzImageBuildTemplate
+  - where:
+      subject: Template
+      parameter-name: JsonFilePath
+    set:
+      alias: JsonTemplatePath
+
   # Rename ImageTemplateName -> Name and keep ImageTemplateName as alias in *-AzImageBuildTemplate
   - where:
       subject: Template
@@ -148,35 +162,32 @@ directive:
           - ResourceGroupName
 
   # Generate models and combine them as 1 cmdlet
-  # - model-cmdlet:
-  #   ########### ImageTemplateCustomizer ############
-  #   # Combine as 1 cmdlet named New-AzImageBuilderTemplateCustomizerObject
-  #   - ImageTemplateCustomizer
-  #   - ImageTemplateShellCustomizer
-  #   - ImageTemplateRestartCustomizer
-  #   - ImageTemplateWindowsUpdateCustomizer
-  #   - ImageTemplatePowerShellCustomizer
-  #   - ImageTemplateFileCustomizer
-  #   ########## ImageTemplateDistributor ###########
-  #   # Combine as 1 cmdlet named New-AzImageBuilderTemplateDistributorObject
-  #   - ImageTemplateDistributor
-  #   - ImageTemplateManagedImageDistributor
-  #   - ImageTemplateSharedImageDistributor
-  #   - ImageTemplateVhdDistributor
-  #   ############# ImageTemplateSource ##############
-  #   # Combine as 1 cmdlet named New-AzImageBuilderTemplateSourceObject
-  #   - ImageTemplateSource
-  #   # Note: publisher, offer, sku and version are required
-  #   - ImageTemplatePlatformImageSource 
-  #   - ImageTemplateManagedImageSource
-  #   - ImageTemplateSharedImageVersionSource
-  #   ########## ImageTemplateInVMValidator ###########
-  #   # Combine as 1 cmdlet named New-AzImageBuilderTemplateValidatorObject
-  #   - ImageTemplateInVMValidator
-  #   - ImageTemplateShellValidator
-  #   - ImageTemplatePowerShellValidator
-  #   ########## AzImageBuilderTemplateDistributorVersioning ###########
-  #   - DistributeVersioner
-  #   - DistributeVersionerLatest
-  #   - DistributeVersionerSource
+  - model-cmdlet:
+    ########### ImageTemplateCustomizer ############
+    # Combine as 1 cmdlet named New-AzImageBuilderTemplateCustomizerObject
+    # - model-name: ImageTemplateShellCustomizer
+    # - model-name: ImageTemplateRestartCustomizer
+    # - model-name: ImageTemplateWindowsUpdateCustomizer
+    # - model-name: ImageTemplatePowerShellCustomizer
+    # - model-name: ImageTemplateFileCustomizer
+    ########## ImageTemplateDistributor ###########
+    # Combine as 1 cmdlet named New-AzImageBuilderTemplateDistributorObject
+    # - model-name: ImageTemplateManagedImageDistributor
+    # - model-name: ImageTemplateSharedImageDistributor
+    # - model-name: ImageTemplateVhdDistributor
+    ############# ImageTemplateSource ##############
+    # Combine as 1 cmdlet named New-AzImageBuilderTemplateSourceObject
+    # Note: publisher, offer, sku and version are required
+    # - model-name: ImageTemplatePlatformImageSource
+    # - model-name: ImageTemplateManagedImageSource
+    # - model-name: ImageTemplateSharedImageVersionSource
+    ########## ImageTemplateInVMValidator ###########
+    # Combine as 1 cmdlet named New-AzImageBuilderTemplateValidatorObject
+    # - model-name: ImageTemplateShellValidator
+    # - model-name: ImageTemplatePowerShellValidator
+    ########## AzImageBuilderTemplateDistributorVersioning parent model name: DistributeVersioner ########### 
+    - model-name: DistributeVersionerLatest
+      cmdlet-name: New-AzImageBuilderTemplateDistributeVersionerLatestObject
+    - model-name: DistributeVersionerSource
+      cmdlet-name: New-AzImageBuilderTemplateDistributeVersionerSourceObject
 ```

src/ImageBuilder/ImageBuilder.Autorest/UX/Microsoft.VirtualMachineImages/imageTemplates.json

@@ -83,7 +83,7 @@
     },
     {
       "name": "Start-AzImageBuilderTemplate",
-      "description": "Create artifacts from a existing image template",
+      "description": "run artifacts from a existing image template",
       "path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}/run",
       "help": {
         "learnMore": {
@@ -101,7 +101,7 @@
       },
       "examples": [
         {
-          "description": "Create artifacts from a existing image template",
+          "description": "run artifacts from a existing image template",
           "parameters": [
             {
               "name": "-Name",