cherry-pick d94a07e from generation

Author: v-vprasannak

src/Communication/Communication.Autorest/.gitattributes

@@ -0,0 +1 @@
+* text=auto

src/Communication/Communication.Autorest/.gitignore

@@ -0,0 +1,16 @@
+bin
+obj
+.vs
+generated
+internal
+exports
+tools
+custom/*.psm1
+custom/autogen-model-cmdlets
+test/*-TestResults.xml
+/*.ps1
+/*.ps1xml
+/*.psm1
+/*.snk
+/*.csproj
+/*.nuspec

src/Communication/Communication.Autorest/Az.Communication.psd1

@@ -0,0 +1,24 @@
+@{
+  GUID = '6f5f191e-e52c-4bd9-87d2-8abb2a4601d8'
+  RootModule = './Az.Communication.psm1'
+  ModuleVersion = '0.1.0'
+  CompatiblePSEditions = 'Core', 'Desktop'
+  Author = 'Microsoft Corporation'
+  CompanyName = 'Microsoft Corporation'
+  Copyright = 'Microsoft Corporation. All rights reserved.'
+  Description = 'Microsoft Azure PowerShell: Communication cmdlets'
+  PowerShellVersion = '5.1'
+  DotNetFrameworkVersion = '4.7.2'
+  RequiredAssemblies = './bin/Az.Communication.private.dll'
+  FormatsToProcess = './Az.Communication.format.ps1xml'
+  FunctionsToExport = 'Get-AzCommunicationService', 'Get-AzCommunicationServiceKey', 'New-AzCommunicationService', 'New-AzCommunicationServiceKey', 'Remove-AzCommunicationService', 'Set-AzCommunicationServiceNotificationHub', 'Test-AzCommunicationServiceNameAvailability', 'Update-AzCommunicationService', '*'
+  AliasesToExport = '*'
+  PrivateData = @{
+    PSData = @{
+      Tags = 'Azure', 'ResourceManager', 'ARM', 'PSModule', 'Communication'
+      LicenseUri = 'https://aka.ms/azps-license'
+      ProjectUri = 'https://github.com/Azure/azure-powershell'
+      ReleaseNotes = ''
+    }
+  }
+}

src/Communication/Communication.Autorest/Properties/AssemblyInfo.cs

@@ -27,13 +27,13 @@ For information on how to develop for `Az.Communication`, see [how-to.md](how-to
 > see https://aka.ms/autorest
 
 ``` yaml
-commit: 23ff943dbe3b5ccdc63a6195daa0f30b17ed9d88
+commit: 663ea6835c33bca216b63f777227db6a459a06b3
 require:
 # readme.azure.noprofile.md is the common configuration file
   - $(this-folder)/../../readme.azure.noprofile.md
 input-file:
 # You need to specify your swagger files here.
-  - $(repo)/specification/communication/resource-manager/Microsoft.Communication/stable/2020-08-20/CommunicationService.json
+  - $(repo)/specification/communication/resource-manager/Microsoft.Communication/preview/2023-06-01-preview/CommunicationServices.json
 
 # If the swagger has not been put in the repo, you may uncomment the following line and refer to it locally
 # - (this-folder)/relative-path-to-your-swagger 
@@ -97,4 +97,25 @@ directive:
       variant: ^Check$|^CheckViaIdentity$|^CheckViaIdentityExpanded$
       subject: CommunicationServiceNameAvailability
     remove: true
+  # Set a default value for Type parameter of Test-AzCommunicationServiceNameAvailability
+  - from: types.json
+    where: $.definitions.CheckNameAvailabilityRequest
+    transform: >
+      return {
+        "description": "The check availability request body.",
+        "type": "object",
+        "properties": {
+          "name": {
+            "description": "The name of the resource for which availability needs to be checked.",
+            "type": "string"
+          },
+          "type": {
+            "description": "The resource type.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name"
+        ]
+      }
 ```

src/Communication/Communication.Autorest/README.md

@@ -1,6 +1,6 @@
 {
   "resourceType": "communicationServices",
-  "apiVersion": "2020-08-20",
+  "apiVersion": "2023-06-01-preview",
   "learnMore": {
     "url": "https://learn.microsoft.com/powershell/module/az.communication"
   },

src/Communication/Communication.Autorest/UX/Microsoft.Communication/communicationServices.json

@@ -89,7 +89,7 @@ if(-not $Debugger) {
   $null = Remove-Item -Recurse -ErrorAction SilentlyContinue -Path (Join-Path $binFolder 'Debug'), (Join-Path $binFolder 'Release')
 }
 
-$dll = Join-Path $PSScriptRoot 'bin\Az.Communication.private.dll'
+$dll = Join-Path $PSScriptRoot 'bin/Az.Communication.private.dll'
 if(-not (Test-Path $dll)) {
   Write-Error "Unable to find output assembly in '$binFolder'."
 }
@@ -98,7 +98,7 @@ if(-not (Test-Path $dll)) {
 $null = Import-Module -Name $dll
 
 $modulePaths = $dll
-$customPsm1 = Join-Path $PSScriptRoot 'custom\Az.Communication.custom.psm1'
+$customPsm1 = Join-Path $PSScriptRoot 'custom/Az.Communication.custom.psm1'
 if(Test-Path $customPsm1) {
   $modulePaths = @($dll, $customPsm1)
 }
@@ -170,8 +170,8 @@ if (Test-Path (Join-Path $PSScriptRoot 'generate-portal-ux.ps1'))
 }
 
 if (-not $DisableAfterBuildTasks){
-  $afterBuildTasksPath = Join-Path $PSScriptRoot ''
-  $afterBuildTasksArgs = ConvertFrom-Json 'true' -AsHashtable
+  $afterBuildTasksPath = Join-Path $PSScriptRoot '../../../tools/BuildScripts/AdaptAutorestModule.ps1'
+  $afterBuildTasksArgs = ConvertFrom-Json '{"SubModuleName":"Communication","ModuleRootName":"$(root-module-name)"}' -AsHashtable
   if(Test-Path -Path $afterBuildTasksPath -PathType leaf){
     Write-Host -ForegroundColor Green 'Running after build tasks...'
     . $afterBuildTasksPath @afterBuildTasksArgs

src/Communication/Communication.Autorest/build-module.ps1

@@ -22,8 +22,8 @@ function CreateModelCmdlet {
         return
     }
 
-    $ModelCsPath = Join-Path (Join-Path $PSScriptRoot 'generated\api') 'Models'
-    $OutputDir = Join-Path $PSScriptRoot 'custom\autogen-model-cmdlets'
+    $ModelCsPath = Join-Path (Join-Path $PSScriptRoot 'generated/api') 'Models'
+    $OutputDir = Join-Path $PSScriptRoot 'custom/autogen-model-cmdlets'
     $null = New-Item -ItemType Directory -Force -Path $OutputDir
     if (''.length -gt 0) {
         $ModuleName = ''

src/Communication/Communication.Autorest/create-model-cmdlets.ps1

@@ -1,9 +1,9 @@
 # region Generated 
   # Load the private module dll
-  $null = Import-Module -PassThru -Name (Join-Path $PSScriptRoot '..\bin\Az.Communication.private.dll')
+  $null = Import-Module -PassThru -Name (Join-Path $PSScriptRoot '../bin/Az.Communication.private.dll')
 
   # Load the internal module
-  $internalModulePath = Join-Path $PSScriptRoot '..\internal\Az.Communication.internal.psm1'
+  $internalModulePath = Join-Path $PSScriptRoot '../internal/Az.Communication.internal.psm1'
   if(Test-Path $internalModulePath) {
     $null = Import-Module -Name $internalModulePath
   }

src/Communication/Communication.Autorest/custom/Az.Communication.custom.psm1

@@ -1,5 +1,5 @@
 # Custom
-This directory contains custom implementation for non-generated cmdlets for the `Az.Communication` module. Both scripts (`.ps1`) and C# files (`.cs`) can be implemented here. They will be used during the build process in `build-module.ps1`, and create cmdlets into the `..\exports` folder. The only generated file into this folder is the `Az.Communication.custom.psm1`. This file should not be modified.
+This directory contains custom implementation for non-generated cmdlets for the `Az.Communication` module. Both scripts (`.ps1`) and C# files (`.cs`) can be implemented here. They will be used during the build process in `build-module.ps1`, and create cmdlets into the `../exports` folder. The only generated file into this folder is the `Az.Communication.custom.psm1`. This file should not be modified.
 
 ## Info
 - Modifiable: yes
@@ -15,10 +15,10 @@ For C# cmdlets, they are compiled with the rest of the generated low-level cmdle
 For script cmdlets, these are loaded via the `Az.Communication.custom.psm1`. Then, during the build process, this module is loaded and processed in the same manner as the C# cmdlets. The fundamental difference is the script cmdlets use the `ParameterSetName` attribute and C# cmdlets do not. To create a script cmdlet variant of a generated cmdlet, simply decorate all parameters in the script with the new `ParameterSetName` in the `Parameter` attribute. This will appropriately treat each parameter set as a separate variant when processed to be exported during the build.
 
 ## Purpose
-This allows the modules to have cmdlets that were not defined in the REST specification. It also allows combining logic using generated cmdlets. This is a level of customization beyond what can be done using the [readme configuration options](https://github.com/Azure/autorest/blob/master/docs/powershell/options.md) that are currently available. These custom cmdlets are then referenced by the cmdlets created at build-time in the `..\exports` folder.
+This allows the modules to have cmdlets that were not defined in the REST specification. It also allows combining logic using generated cmdlets. This is a level of customization beyond what can be done using the [readme configuration options](https://github.com/Azure/autorest/blob/master/docs/powershell/options.md) that are currently available. These custom cmdlets are then referenced by the cmdlets created at build-time in the `../exports` folder.
 
 ## Usage
-The easiest way currently to start developing custom cmdlets is to copy an existing cmdlet. For C# cmdlets, copy one from the `generated/cmdlets` folder. For script cmdlets, build the project using `build-module.ps1` and copy one of the scripts from the `..\exports` folder. After that, if you want to add new parameter sets, follow the guidelines in the `Details` section above. For implementing a new cmdlets, at minimum, please keep these parameters:
+The easiest way currently to start developing custom cmdlets is to copy an existing cmdlet. For C# cmdlets, copy one from the `generated/cmdlets` folder. For script cmdlets, build the project using `build-module.ps1` and copy one of the scripts from the `../exports` folder. After that, if you want to add new parameter sets, follow the guidelines in the `Details` section above. For implementing a new cmdlets, at minimum, please keep these parameters:
 - Break
 - DefaultProfile
 - HttpPipelineAppend
@@ -36,6 +36,6 @@ For processing the cmdlets, we've created some additional attributes:
 - `Microsoft.Azure.PowerShell.Cmdlets.Communication.DoNotExportAttribute`
   - Used in C# and script cmdlets to suppress creating an exported cmdlet at build-time. These cmdlets will *not be exposed* by `Az.Communication`.
 - `Microsoft.Azure.PowerShell.Cmdlets.Communication.InternalExportAttribute`
-  - Used in C# cmdlets to route exported cmdlets to the `..\internal`, which are *not exposed* by `Az.Communication`. For more information, see [README.md](..\internal/README.md) in the `..\internal` folder.
+  - Used in C# cmdlets to route exported cmdlets to the `../internal`, which are *not exposed* by `Az.Communication`. For more information, see [README.md](../internal/README.md) in the `../internal` folder.
 - `Microsoft.Azure.PowerShell.Cmdlets.Communication.ProfileAttribute`
   - Used in C# and script cmdlets to define which Azure profiles the cmdlet supports. This is only supported for Azure (`--azure`) modules.

src/Communication/Communication.Autorest/custom/README.md

@@ -1,6 +1,6 @@
 ---
 Module Name: Az.Communication
-Module Guid: 32c4dede-9b85-43d4-83ab-447e2938c400
+Module Guid: 6f5f191e-e52c-4bd9-87d2-8abb2a4601d8
 Download Help Link: https://learn.microsoft.com/powershell/module/az.communication
 Help Version: 1.0.0.0
 Locale: en-US

src/Communication/Communication.Autorest/help/Az.Communication.md renamed to src/Communication/Communication.Autorest/docs/Az.Communication.md

@@ -42,29 +42,30 @@ Get the CommunicationService and its properties.
 
 ### Example 1: List existing CommunicationServices for a Subscription
 ```powershell
-Get-AzCommunicationService -SubscriptionId 73fc3592-3cef-4300-5e19-8d18b65ce0e8
+Get-AzCommunicationService -SubscriptionId 632ec9eb-fad7-4cbd-993a-e72973ba2acc
 ```
 
 ```output
-Location Name             Type                                          AzureAsyncOperation
--------- ----             ----                                          -------------------
-global   ContosoResource1   Microsoft.Communication/communicationServices
-global   ContosoResource4   Microsoft.Communication/communicationServices
-global   ContosoResource3   Microsoft.Communication/communicationServices
-global   ContosoResource5   Microsoft.Communication/communicationServices
+Location Name                SystemDataCreatedAt  SystemDataCreatedBy         SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy   SystemDataLastModifiedByType
+-------- ----                -------------------  -------------------         ----------------------- ------------------------ ------------------------   ----------------------------
+Global   ContosoAcsResource1 7/09/2024 4:41:40 AM [email protected]   User                    7/09/2024 4:41:40 AM     [email protected]  User
+Global   ContosoAcsResource2 4/10/2024 2:41:40 AM [email protected]  User                    4/10/2024 2:41:40 AM     [email protected] User
+Global   ContosoAcsResource3 5/01/2024 1:41:40 AM [email protected]  User                    5/01/2024 1:41:40 AM     [email protected] User
+Global   ContosoAcsResource4 6/08/2024 5:41:40 AM [email protected]  User                    6/08/2024 5:41:40 AM     [email protected] User
+Global   ContosoAcsResource5 6/09/2024 4:41:40 AM [email protected]  User                    6/09/2024 4:41:40 AM     [email protected] User
 ```
 
 Returns a list of all ACS resources under that subscription.
 
 ### Example 2: Get infomation on specified Azure Communication resource
 ```powershell
-Get-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1
+Get-AzCommunicationService -Name ContosoAcsResource34 -ResourceGroupName ContosoResourceProvider1
 ```
 
 ```output
-Location Name           Type                                          AzureAsyncOperation
--------- ----           ----                                          -------------------
-Global   ContosoAcsResource1 Microsoft.Communication/communicationServices
+Location Name                SystemDataCreatedAt  SystemDataCreatedBy        SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy  SystemDataLastModifiedByType
+-------- ----                -------------------  -------------------        ----------------------- ------------------------ ------------------------  ----------------------------
+Global   ContosoAcsResource1 7/10/2024 4:41:40 AM [email protected]  User                    7/10/2024 9:02:15 AM     [email protected] User
 ```
 
 Returns the information on an ACS resource, if one matching provided parameters is found.
@@ -136,6 +137,7 @@ Accept wildcard characters: False
 
 ### -SubscriptionId
 The ID of the target subscription.
+The value must be an UUID.
 
 ```yaml
 Type: System.String[]
@@ -158,7 +160,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## OUTPUTS
 
-### Microsoft.Azure.PowerShell.Cmdlets.Communication.Models.Api20200820.ICommunicationServiceResource
+### Microsoft.Azure.PowerShell.Cmdlets.Communication.Models.Api20230601Preview.ICommunicationServiceResource
 
 ## NOTES
 

src/Communication/Communication.Autorest/help/Get-AzCommunicationService.md renamed to src/Communication/Communication.Autorest/docs/Get-AzCommunicationService.md

@@ -86,6 +86,7 @@ Accept wildcard characters: False
 
 ### -SubscriptionId
 The ID of the target subscription.
+The value must be an UUID.
 
 ```yaml
 Type: System.String[]
@@ -137,7 +138,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## OUTPUTS
 
-### Microsoft.Azure.PowerShell.Cmdlets.Communication.Models.Api20200820.ICommunicationServiceKeys
+### Microsoft.Azure.PowerShell.Cmdlets.Communication.Models.Api20230601Preview.ICommunicationServiceKeys
 
 ## NOTES