Migrate ConnectedMachine from generation to main (#25013)

* Move ConnectedMachine to main

* add ChangeLog and suppress Signature Issues

---------

Co-authored-by: YanaXu <[email protected]>

Author: azure-powershell-bot

src/ConnectedMachine/ConnectedMachine.Autorest/Az.ConnectedMachine.format.ps1xml

@@ -11,7 +11,7 @@
   DotNetFrameworkVersion = '4.7.2'
   RequiredAssemblies = './bin/Az.ConnectedMachine.private.dll'
   FormatsToProcess = './Az.ConnectedMachine.format.ps1xml'
-  FunctionsToExport = 'Connect-AzConnectedMachine', 'Get-AzConnectedExtensionMetadata', 'Get-AzConnectedMachine', 'Get-AzConnectedMachineExtension', 'Get-AzConnectedMachineRunCommand', 'Get-AzConnectedPrivateLinkScope', 'Install-AzConnectedMachinePatch', 'Invoke-AzConnectedAssessMachinePatch', 'New-AzConnectedMachineExtension', 'New-AzConnectedMachineRunCommand', 'New-AzConnectedPrivateLinkScope', 'Remove-AzConnectedMachine', 'Remove-AzConnectedMachineExtension', 'Remove-AzConnectedMachineRunCommand', 'Remove-AzConnectedPrivateLinkScope', 'Set-AzConnectedMachineExtension', 'Set-AzConnectedPrivateLinkScope', 'Update-AzConnectedExtension', 'Update-AzConnectedMachine', 'Update-AzConnectedMachineExtension', 'Update-AzConnectedMachineRunCommand', 'Update-AzConnectedPrivateLinkScopeTag'
+  FunctionsToExport = 'Connect-AzConnectedMachine', 'Get-AzConnectedExtensionMetadata', 'Get-AzConnectedLicense', 'Get-AzConnectedMachine', 'Get-AzConnectedMachineExtension', 'Get-AzConnectedMachineRunCommand', 'Get-AzConnectedNetworkSecurityPerimeterConfiguration', 'Get-AzConnectedPrivateLinkScope', 'Install-AzConnectedMachinePatch', 'Invoke-AzConnectedAssessMachinePatch', 'New-AzConnectedLicense', 'New-AzConnectedLicenseDetail', 'New-AzConnectedMachineExtension', 'New-AzConnectedMachineRunCommand', 'New-AzConnectedPrivateLinkScope', 'Remove-AzConnectedLicense', 'Remove-AzConnectedMachine', 'Remove-AzConnectedMachineExtension', 'Remove-AzConnectedMachineRunCommand', 'Remove-AzConnectedPrivateLinkScope', 'Set-AzConnectedLicense', 'Set-AzConnectedMachineExtension', 'Set-AzConnectedPrivateLinkScope', 'Update-AzConnectedExtension', 'Update-AzConnectedMachine', 'Update-AzConnectedMachineExtension', 'Update-AzConnectedMachineRunCommand', 'Update-AzConnectedPrivateLinkScopeTag'
   PrivateData = @{
     PSData = @{
       Tags = 'Azure', 'ResourceManager', 'ARM', 'PSModule', 'ConnectedMachine'

src/ConnectedMachine/ConnectedMachine.Autorest/Az.ConnectedMachine.psd1

@@ -38,12 +38,12 @@ In this directory, run AutoRest:
 > see https://aka.ms/autorest
  
 ``` yaml
-commit: 2d044b8a317aff46d45080f5a797ac376955f648
+commit: 9c51b17f1c544eea0f6a67c01a6b763995521f52
 require:
   - $(this-folder)/../../readme.azure.noprofile.md
 input-file:
-  - $(repo)/specification/hybridcompute/resource-manager/Microsoft.HybridCompute/preview/2023-10-03-preview/HybridCompute.json
-  - $(repo)/specification/hybridcompute/resource-manager/Microsoft.HybridCompute/preview/2023-10-03-preview/privateLinkScopes.json
+  - $(repo)/specification/hybridcompute/resource-manager/Microsoft.HybridCompute/preview/2024-03-31-preview/HybridCompute.json
+  - $(repo)/specification/hybridcompute/resource-manager/Microsoft.HybridCompute/preview/2024-03-31-preview/privateLinkScopes.json
 
 module-version: 0.5.0
 title: ConnectedMachine
@@ -81,16 +81,7 @@ directive:
             "description": "The expand expression to apply on the operation.",
           }
         ]
- 
-  - from: swagger-document
-    where: $.definitions.Machine.properties.properties
-    transform: >-
-      return {
-          "x-ms-client-flatten": true,
-          "$ref": "#/definitions/MachineProperties",
-          "description": "Hybrid Compute Machine properties"
-        }
- 
+
   - from: swagger-document
     where: $.definitions.MachineExtensionUpdateProperties.properties
     transform: >-
@@ -130,6 +121,7 @@ directive:
           "description": "The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all."
         }
       }
+
   - from: swagger-document
     where: $.definitions.MachineExtensionProperties.properties
     transform: >-
@@ -178,6 +170,7 @@ directive:
           "description": "The machine extension instance view."
         }
       }
+
   # add 200 response to run-command delete 
   - from: swagger-document
     where: $.paths["/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/runCommands/{runCommandName}"].delete.responses
@@ -210,7 +203,7 @@ directive:
         "default": {
           "description": "Error response describing why the operation failed.",
           "schema": {
-            "$ref": "https://github.com/Azure/azure-rest-api-specs/blob/2d044b8a317aff46d45080f5a797ac376955f648/specification/common-types/resource-management/v3/types.json#/definitions/ErrorResponse"
+            "$ref": "../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse"
           }
         }
       }
@@ -327,21 +320,48 @@ directive:
       subject: MachineRunCommand
       verb: Set
     remove: true
+  # internal API
+  - where:
+      subject: LicenseProfile
+    remove: true
+  - where:
+      subject: Extension
+      variant: Upgrade
+    remove: true
+
+  # we will release gateway and setting commands in a seperate module
+  - where:
+      subject: Gateway
+    remove: true
+  - where:
+      subject: Setting
+    remove: true
 
-  # add back when swagger change is checked in
+  # We don't want user to send PATCH to the ESU license API
   - where:
       subject: License
+      verb: Update
     remove: true
   - where:
-      subject: LicenseProfile
+      subject: License
+      verb: Validate
     remove: true
+  - where:
+      subject: License
+      verb: Test
+    remove: true
+
+  # We don't want user to talk directly to the network configuration API
   - where:
       subject: NetworkConfiguration
     remove: true
+
+  # Remove when this API is fixed
   - where:
-      subject: NetworkSecurityPerimeterConfiguration$
+      subject: ReconcileNetworkSecurityPerimeterConfiguration$
+      verb: Invoke
     remove: true
- 
+
   # Removing non-expand commands
   - where:
       subject: MachinePatch
@@ -364,7 +384,13 @@ directive:
         description: Gets the list of ResourceGroupName's available for this subscription.
         script: Get-AzResourceGroup | Select-Object -ExpandProperty ResourceGroupName
 
-  # These APIs are used by the agent so they do not need to be in the cmdlets.
+  # These APIs are used by the agent so they do not need to be in the cmdlets
   - remove-operation: Machines_CreateOrUpdate
   - remove-operation: MachineRunCommands_Update
+
+  # Create model cmdlet for complex object
+  - model-cmdlet:
+    - model-name: LicenseDetails
+      cmdlet-name: New-AzConnectedLicenseDetail
+
 ```

src/ConnectedMachine/ConnectedMachine.Autorest/README.md

@@ -0,0 +1,85 @@
+{
+  "resourceType": "licenses",
+  "apiVersion": "2024-03-31-preview",
+  "learnMore": {
+    "url": "https://learn.microsoft.com/powershell/module/az.connectedmachine"
+  },
+  "commands": [
+    {
+      "name": "Get-AzConnectedLicense",
+      "description": "Retrieves information about the view of a license.",
+      "path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/licenses/{licenseName}",
+      "help": {
+        "learnMore": {
+          "url": "https://learn.microsoft.com/powershell/module/az.connectedmachine/get-azconnectedlicense"
+        },
+        "parameterSets": [
+          {
+            "parameters": [
+              "-Name <String>",
+              "-ResourceGroupName <String>",
+              "[-SubscriptionId <String[]>]"
+            ]
+          }
+        ]
+      },
+      "examples": [
+        {
+          "description": "Retrieves information about the view of a license.",
+          "parameters": [
+            {
+              "name": "-Name",
+              "value": "[Path.licenseName]"
+            },
+            {
+              "name": "-ResourceGroupName",
+              "value": "[Path.resourceGroupName]"
+            },
+            {
+              "name": "-SubscriptionId",
+              "value": "[Path.subscriptionId]"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Remove-AzConnectedLicense",
+      "description": "The operation to delete a license.",
+      "path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/licenses/{licenseName}",
+      "help": {
+        "learnMore": {
+          "url": "https://learn.microsoft.com/powershell/module/az.connectedmachine/remove-azconnectedlicense"
+        },
+        "parameterSets": [
+          {
+            "parameters": [
+              "-Name <String>",
+              "-ResourceGroupName <String>",
+              "[-SubscriptionId <String>]"
+            ]
+          }
+        ]
+      },
+      "examples": [
+        {
+          "description": "The operation to delete a license.",
+          "parameters": [
+            {
+              "name": "-Name",
+              "value": "[Path.licenseName]"
+            },
+            {
+              "name": "-ResourceGroupName",
+              "value": "[Path.resourceGroupName]"
+            },
+            {
+              "name": "-SubscriptionId",
+              "value": "[Path.subscriptionId]"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

src/ConnectedMachine/ConnectedMachine.Autorest/UX/Microsoft.HybridCompute/licenses.json

@@ -1,6 +1,6 @@
 {
   "resourceType": "locations/publishers/extensionTypes/versions",
-  "apiVersion": "2023-10-03-preview",
+  "apiVersion": "2024-03-31-preview",
   "learnMore": {
     "url": "https://learn.microsoft.com/powershell/module/az.connectedmachine"
   },

src/ConnectedMachine/ConnectedMachine.Autorest/UX/Microsoft.HybridCompute/locations-publishers-extensionTypes-versions.json

@@ -1,6 +1,6 @@
 {
   "resourceType": "machines/extensions",
-  "apiVersion": "2023-10-03-preview",
+  "apiVersion": "2024-03-31-preview",
   "learnMore": {
     "url": "https://learn.microsoft.com/powershell/module/az.connectedmachine"
   },

src/ConnectedMachine/ConnectedMachine.Autorest/UX/Microsoft.HybridCompute/machines-extensions.json

@@ -1,6 +1,6 @@
 {
   "resourceType": "machines/runCommands",
-  "apiVersion": "2023-10-03-preview",
+  "apiVersion": "2024-03-31-preview",
   "learnMore": {
     "url": "https://learn.microsoft.com/powershell/module/az.connectedmachine"
   },

src/ConnectedMachine/ConnectedMachine.Autorest/UX/Microsoft.HybridCompute/machines-runCommands.json

@@ -1,6 +1,6 @@
 {
   "resourceType": "machines",
-  "apiVersion": "2023-10-03-preview",
+  "apiVersion": "2024-03-31-preview",
   "learnMore": {
     "url": "https://learn.microsoft.com/powershell/module/az.connectedmachine"
   },

src/ConnectedMachine/ConnectedMachine.Autorest/UX/Microsoft.HybridCompute/machines.json

@@ -0,0 +1,52 @@
+{
+  "resourceType": "privateLinkScopes/networkSecurityPerimeterConfigurations",
+  "apiVersion": "2024-03-31-preview",
+  "learnMore": {
+    "url": "https://learn.microsoft.com/powershell/module/az.connectedmachine"
+  },
+  "commands": [
+    {
+      "name": "Get-AzConnectedNetworkSecurityPerimeterConfiguration",
+      "description": "Gets the network security perimeter configuration for a private link scope.",
+      "path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/privateLinkScopes/{scopeName}/networkSecurityPerimeterConfigurations/{perimeterName}",
+      "help": {
+        "learnMore": {
+          "url": "https://learn.microsoft.com/powershell/module/az.connectedmachine/get-azconnectednetworksecurityperimeterconfiguration"
+        },
+        "parameterSets": [
+          {
+            "parameters": [
+              "-PerimeterName <String>",
+              "-ResourceGroupName <String>",
+              "-ScopeName <String>",
+              "[-SubscriptionId <String[]>]"
+            ]
+          }
+        ]
+      },
+      "examples": [
+        {
+          "description": "Gets the network security perimeter configuration for a private link scope.",
+          "parameters": [
+            {
+              "name": "-PerimeterName",
+              "value": "[Path.perimeterName]"
+            },
+            {
+              "name": "-ResourceGroupName",
+              "value": "[Path.resourceGroupName]"
+            },
+            {
+              "name": "-ScopeName",
+              "value": "[Path.scopeName]"
+            },
+            {
+              "name": "-SubscriptionId",
+              "value": "[Path.subscriptionId]"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

src/ConnectedMachine/ConnectedMachine.Autorest/UX/Microsoft.HybridCompute/privateLinkScopes-networkSecurityPerimeterConfigurations.json

@@ -1,6 +1,6 @@
 {
   "resourceType": "privateLinkScopes",
-  "apiVersion": "2023-10-03-preview",
+  "apiVersion": "2024-03-31-preview",
   "learnMore": {
     "url": "https://learn.microsoft.com/powershell/module/az.connectedmachine"
   },