Merge pull request #14678 from Azure/internal/release

[Do not squash] [CloudService] Second preview release for CloudService (#14653)

Author: dingmeng-xue

src/CloudService/Az.CloudService.format.ps1xml

@@ -3,7 +3,7 @@
 #
 # Generated by: Microsoft Corporation
 #
-# Generated on: 2021-03-02
+# Generated on: 2021-03-30
 #
 
 @{
@@ -12,7 +12,7 @@
 RootModule = './Az.CloudService.psm1'
 
 # Version number of this module.
-ModuleVersion = '0.1.0'
+ModuleVersion = '0.2.0'
 
 # Supported PSEditions
 CompatiblePSEditions = 'Core', 'Desktop'
@@ -70,8 +70,8 @@ FormatsToProcess = './Az.CloudService.format.ps1xml'
 
 # Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
 FunctionsToExport = 'Get-AzCloudService', 'Get-AzCloudServiceInstanceView', 
-               'Get-AzCloudServiceNetworkInterfaces', 
-               'Get-AzCloudServicePublicIPAddress', 
+               'Get-AzCloudServiceNetworkInterfaces', 'Get-AzCloudServiceOSFamily', 
+               'Get-AzCloudServiceOSVersion', 'Get-AzCloudServicePublicIPAddress', 
                'Get-AzCloudServiceRoleInstance', 
                'Get-AzCloudServiceRoleInstanceRemoteDesktopFile', 
                'Get-AzCloudServiceRoleInstanceView', 
@@ -127,7 +127,8 @@ PrivateData = @{
         # IconUri = ''
 
         # ReleaseNotes of this module
-        # ReleaseNotes = ''
+        ReleaseNotes = '* Bumped API version to stable 2021-03-01
+        * Supported OSFamily and OSVersion'
 
         # Prerelease string of this module
         # Prerelease = ''

src/CloudService/Az.CloudService.psd1

@@ -19,6 +19,10 @@
 -->
 ## Upcoming Release
 
+## Version 0.2.0
+* Bumped API version to stable 2021-03-01
+* Supported OSFamily and OSVersion
+
 ## Version 0.1.0
 * First preview release for module Az.CloudService
 

src/CloudService/Changelog.md

@@ -24,5 +24,5 @@
 [assembly: ComVisible(false)]
 [assembly: CLSCompliant(false)]
 [assembly: Guid("1fe4b4c7-44d2-4800-a935-733381e663ae")]
-[assembly: AssemblyVersion("0.1.0")]
-[assembly: AssemblyFileVersion("0.1.0")]
+[assembly: AssemblyVersion("0.2.0")]
+[assembly: AssemblyFileVersion("0.2.0")]

src/CloudService/Properties/AssemblyInfo.cs

@@ -44,7 +44,7 @@ function Get-AzCloudServiceNetworkInterfaces {
         [string] $RoleInstanceName,
 
         [Parameter(Mandatory=$true, ParameterSetName="CloudService", HelpMessage="CloudService instance.")]
-        [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.CloudService] $CloudService
+        [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.CloudService] $CloudService
     )
     process {
         $ApiVersion = "2020-06-01"

src/CloudService/custom/Get-AzCloudServiceNetworkInterface.ps1

@@ -38,7 +38,7 @@ function Get-AzCloudServicePublicIPAddress {
         [string] $CloudServiceName,
 
         [Parameter(Mandatory=$true, ParameterSetName="CloudService", HelpMessage="CloudService instance.")]
-        [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.CloudService] $CloudService
+        [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.CloudService] $CloudService
     )
     process {
         $ApiVersion = "2020-06-01"

src/CloudService/custom/Get-AzCloudServicePublicIPAddress.ps1

@@ -19,11 +19,13 @@ Create a in-memory object for Diagnostics Extension
 Create a in-memory object for Diagnostics Extension
 
 .Outputs
-Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.Extension
+Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.Extension
+.Link
+https://docs.microsoft.com/powershell/module/az.CloudService/New-AzCloudServiceDiagnosticsExtension
 #>
 
 function New-AzCloudServiceDiagnosticsExtension {
-  [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.Extension')]
+  [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.Extension')]
   param(
     [Parameter(HelpMessage="Name of Diagnostics Extension.", Mandatory)]
     [string] $Name,

src/CloudService/custom/New-AzCloudServiceDiagnosticsExtension.ps1

@@ -20,12 +20,12 @@ Create a in-memory object for Extension
 Create a in-memory object for Extension
 
 .Outputs
-Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.Extension
+Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.Extension
 .Link
 https://docs.microsoft.com/powershell/module/az.CloudService/new-AzCloudServiceExtensionObject
 #>
 function New-AzCloudServiceExtensionObject {
-    [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.Extension')]
+    [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.Extension')]
     [CmdletBinding(PositionalBinding=$false)]
     Param(
 
@@ -56,7 +56,7 @@ function New-AzCloudServiceExtensionObject {
     )
 
     process {
-        $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.Extension]::New()
+        $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.Extension]::New()
 
         $Object.AutoUpgradeMinorVersion = $AutoUpgradeMinorVersion
         $Object.Name = $Name

src/CloudService/custom/New-AzCloudServiceExtensionObject.ps1

@@ -20,25 +20,25 @@ Create a in-memory object for LoadBalancerConfiguration
 Create a in-memory object for LoadBalancerConfiguration
 
 .Outputs
-Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.LoadBalancerConfiguration
+Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.LoadBalancerConfiguration
 .Link
 https://docs.microsoft.com/powershell/module/az.CloudService/new-AzCloudServiceLoadBalancerConfigurationObject
 #>
 function New-AzCloudServiceLoadBalancerConfigurationObject {
-    [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.LoadBalancerConfiguration')]
+    [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.LoadBalancerConfiguration')]
     [CmdletBinding(PositionalBinding=$false)]
     Param(
 
         [Parameter(HelpMessage="FrontendIPConfiguration.")]
-        [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.ILoadBalancerFrontendIPConfiguration[]]
+        [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.ILoadBalancerFrontendIPConfiguration[]]
         $FrontendIPConfiguration,
         [Parameter(HelpMessage="Name of LoadBalancerConfiguration.")]
         [string]
         $Name
     )
 
     process {
-        $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.LoadBalancerConfiguration]::New()
+        $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.LoadBalancerConfiguration]::New()
 
         $Object.FrontendIPConfiguration = $FrontendIPConfiguration
         $Object.Name = $Name

src/CloudService/custom/New-AzCloudServiceLoadBalancerConfigurationObject.ps1

@@ -20,12 +20,12 @@ Create a in-memory object for LoadBalancerFrontendIPConfiguration
 Create a in-memory object for LoadBalancerFrontendIPConfiguration
 
 .Outputs
-Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.LoadBalancerFrontendIPConfiguration
+Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.LoadBalancerFrontendIPConfiguration
 .Link
 https://docs.microsoft.com/powershell/module/az.CloudService/new-AzCloudServiceLoadBalancerFrontendIPConfigurationObject
 #>
 function New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject {
-    [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.LoadBalancerFrontendIPConfiguration')]
+    [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.LoadBalancerFrontendIPConfiguration')]
     [CmdletBinding(PositionalBinding=$false)]
     Param(
 
@@ -38,7 +38,7 @@ function New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject {
     )
 
     process {
-        $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.LoadBalancerFrontendIPConfiguration]::New()
+        $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.LoadBalancerFrontendIPConfiguration]::New()
 
         $Object.Name = $Name
         $Object.PublicIPAddressId = $PublicIPAddressId

src/CloudService/custom/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.ps1

@@ -17,10 +17,15 @@
 Create a in-memory object for Remote Desktop Extension
 .Description
 Create a in-memory object for Remote Desktop Extension
+
+.Outputs
+Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.Extension
+.Link
+https://docs.microsoft.com/powershell/module/az.CloudService/New-AzCloudServiceRemoteDesktopExtensionObject
 #>
 
 function New-AzCloudServiceRemoteDesktopExtensionObject {
-  [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.Extension')]
+  [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.Extension')]
   param(
     [Parameter(HelpMessage="Name of Remote Desktop Extension.", Mandatory)]
     [string] $Name,

src/CloudService/custom/New-AzCloudServiceRemoteDesktopExtensionObject.ps1

@@ -20,12 +20,12 @@ Create a in-memory object for CloudServiceRoleProfileProperties
 Create a in-memory object for CloudServiceRoleProfileProperties
 
 .Outputs
-Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.CloudServiceRoleProfileProperties
+Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.CloudServiceRoleProfileProperties
 .Link
 https://docs.microsoft.com/powershell/module/az.CloudService/new-AzCloudServiceRoleProfilePropertiesObject
 #>
 function New-AzCloudServiceRoleProfilePropertiesObject {
-    [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.CloudServiceRoleProfileProperties')]
+    [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.CloudServiceRoleProfileProperties')]
     [CmdletBinding(PositionalBinding=$false)]
     Param(
 
@@ -44,7 +44,7 @@ function New-AzCloudServiceRoleProfilePropertiesObject {
     )
 
     process {
-        $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.CloudServiceRoleProfileProperties]::New()
+        $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.CloudServiceRoleProfileProperties]::New()
 
         $Object.Name = $Name
         $Object.SkuCapacity = $SkuCapacity

src/CloudService/custom/New-AzCloudServiceRoleProfilePropertiesObject.ps1

@@ -19,13 +19,13 @@ Create a in-memory object for Vault Secret Group
 Create a in-memory object for Secret Group
 
 .Outputs
-Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.CloudServiceVaultSecretGroup
+Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.CloudServiceVaultSecretGroup
 .Link
 https://docs.microsoft.com/powershell/module/az.CloudService/new-AzCloudServiceVaultSecretGroupObject
 #>
 
 function New-AzCloudServiceVaultSecretGroupObject {
-    [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.CloudServiceVaultSecretGroup')]
+    [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.CloudServiceVaultSecretGroup')]
     [CmdletBinding(PositionalBinding=$false)]
     Param(
         [Parameter(HelpMessage="Key Vault Resource Id.")]
@@ -41,12 +41,12 @@ function New-AzCloudServiceVaultSecretGroupObject {
               $certificateUrls = @()
               ForEach ($url in $CertificateUrl)
               {
-                     $cloudServiceVaultCertificate = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.CloudServiceVaultCertificate]::New()
+                     $cloudServiceVaultCertificate = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.CloudServiceVaultCertificate]::New()
                      $cloudServiceVaultCertificate.CertificateUrl = $url
                      $certificateUrls = $certificateUrls + $cloudServiceVaultCertificate
               }
 
-              $cloudServiceVaultSecretGroup = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.CloudServiceVaultSecretGroup]::New()
+              $cloudServiceVaultSecretGroup = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.CloudServiceVaultSecretGroup]::New()
               $cloudServiceVaultSecretGroup.SourceVaultId = $Id
               $cloudServiceVaultSecretGroup.VaultCertificate = $certificateUrls
 

src/CloudService/custom/New-AzCloudServiceVaultSecretGroupObject.ps1

@@ -3,7 +3,7 @@
 using System.Text;
 using Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Json;
 
-namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview
+namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301
 {
     public partial class CloudService
     {

src/CloudService/custom/Serialization/CloudService.cs

@@ -3,7 +3,7 @@
 using System.Text;
 using Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Json;
 
-namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview
+namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301
 {
     public partial class CloudServiceTags
     {

src/CloudService/custom/Serialization/CloudServiceTags.cs

@@ -3,7 +3,7 @@
 using System.Text;
 using Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Json;
 
-namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview
+namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301
 {
     public partial class CloudServiceVaultCertificate
     {

src/CloudService/custom/Serialization/CloudServiceVaultCertificate.cs

@@ -3,7 +3,7 @@
 using System.Text;
 using Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Json;
 
-namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview
+namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301
 {
     public partial class ResourceInstanceViewStatus
     {

src/CloudService/custom/Serialization/ResourceInstanceViewStatus.cs

@@ -3,7 +3,7 @@
 using System.Text;
 using Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Json;
 
-namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview
+namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301
 {
     public partial class RoleInstanceTags
     {

src/CloudService/custom/Serialization/RoleInstanceTags.cs

@@ -3,7 +3,7 @@
 using System.Text;
 using Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Json;
 
-namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview
+namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301
 {
     public partial class StatusCodeCount
     {

src/CloudService/custom/Serialization/StatusCodeCount.cs

@@ -39,7 +39,7 @@ function Switch-AzCloudService {
 
         [Parameter(Mandatory=$true, ParameterSetName="CloudService")]
         [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Path')]
-        [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.CloudService]
+        [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.CloudService]
         ${CloudService},
 
         [Parameter(Mandatory=$true, ParameterSetName="CloudServiceName")]

src/CloudService/custom/Switch-AzCloudService.ps1

@@ -0,0 +1,25 @@
+### Example 1: Get all OS families in a location
+```powershell
+PS C:\> Get-AzCloudServiceOSFamily -location 'westus2'
+
+Name Label
+---- -----
+5    Windows Server 2016
+4    Windows Server 2012 R2
+6    Windows Server 2019
+3    Windows Server 2012
+2    Windows Server 2008 R2
+```
+
+This command gets all OS families in location westus2
+
+### Example 2: Get OS family
+```powershell
+PS C:\> Get-AzCloudServiceOSFamily -location 'westus2' -OSFamilyName 5
+
+Name Label
+---- -----
+5    Windows Server 2016
+```
+
+This command gets OS family named 5 that is located in westus2.

src/CloudService/examples/Get-AzCloudServiceOSFamily.md

@@ -0,0 +1,25 @@
+### Example 1: Get all OS versions in a location
+```powershell
+PS C:\> Get-AzCloudServiceOSVersion -location 'westus2'
+
+Name                        Label                                            IsDefault IsActive Family FamilyLabel
+----                        -----                                            --------- -------- ------ -----------
+WA-GUEST-OS-6.7_201905-01   Windows Azure Guest OS 6.7 (Release 201905-01)   False     False    6      Windows Server 2019
+WA-GUEST-OS-3.21_201411-01  Windows Azure Guest OS 3.21 (Release 201411-01)  False     False    3      Windows Server 2012
+WA-GUEST-OS-3.34_201512-01  Windows Azure Guest OS 3.34 (Release 201512-01)  False     False    3      Windows Server 2012
+WA-GUEST-OS-3.26_201504-01  Windows Azure Guest OS 3.26 (Release 201504-01)  False     False    3      Windows Server 2012
+WA-GUEST-OS-2.46_201512-01  Windows Azure Guest OS 2.46 (Release 201512-01)  False     False    2      Windows Server 2008 R2
+```
+
+This command gets all OS versions in location westus2
+
+### Example 2: Get OS version
+```powershell
+PS C:\> Get-AzCloudServiceOSVersion -location 'westus2' -OSVersionName 'WA-GUEST-OS-6.7_201905-01'
+
+Name                      Label                                          IsDefault IsActive Family FamilyLabel
+----                      -----                                          --------- -------- ------ -----------
+WA-GUEST-OS-6.7_201905-01 Windows Azure Guest OS 6.7 (Release 201905-01) False     False    6      Windows Server 2019
+```
+
+This command gets OS version named WA-GUEST-OS-6.7_201905-01 that is located in westus2.

src/CloudService/examples/Get-AzCloudServiceOSVersion.md

@@ -58,7 +58,7 @@ UpgradeMode       : Auto
 .Inputs
 Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity
 .Outputs
-Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.ICloudService
+Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.ICloudService
 .Notes
 COMPLEX PARAMETER PROPERTIES
 
@@ -67,6 +67,9 @@ To create the parameters described below, construct a hash table containing the
 INPUTOBJECT <ICloudServiceIdentity>: Identity Parameter
   [CloudServiceName <String>]: 
   [Id <String>]: Resource identity path
+  [Location <String>]: Name of the location that the OS version pertains to.
+  [OSFamilyName <String>]: Name of the OS family.
+  [OSVersionName <String>]: Name of the OS version.
   [ResourceGroupName <String>]: 
   [RoleInstanceName <String>]: Name of the role instance.
   [RoleName <String>]: Name of the role.
@@ -76,7 +79,7 @@ INPUTOBJECT <ICloudServiceIdentity>: Identity Parameter
 https://docs.microsoft.com/powershell/module/az.cloudservice/get-azcloudservice
 #>
 function Get-AzCloudService {
-[OutputType([Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.ICloudService])]
+[OutputType([Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.ICloudService])]
 [CmdletBinding(DefaultParameterSetName='List', PositionalBinding=$false)]
 param(
     [Parameter(ParameterSetName='Get', Mandatory)]

src/CloudService/exports/Get-AzCloudService.ps1

@@ -67,12 +67,12 @@ PS C:\>$cloudServiceInstanceView.ToJsonString()
 }
 
 .Outputs
-Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.ICloudServiceInstanceView
+Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.ICloudServiceInstanceView
 .Link
 https://docs.microsoft.com/powershell/module/az.cloudservice/get-azcloudserviceinstanceview
 #>
 function Get-AzCloudServiceInstanceView {
-[OutputType([Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20201001Preview.ICloudServiceInstanceView])]
+[OutputType([Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.ICloudServiceInstanceView])]
 [CmdletBinding(DefaultParameterSetName='Get', PositionalBinding=$false)]
 param(
     [Parameter(Mandatory)]