Code Changes:

-------------
1) ARM cmdlets for SQLVM extension added ( followed DSC's ARM cmdlet pattern )
2) supports configuring auto patching in ARM mode
3) supports configuring auto backup in ARM mode
4) Get sqlvm extension status in ARM mode
5) remove sqlvm extension in ARM mode


Pending Open issues:
------------------
- MAML file generation & help documentation
- adding new functional tests
- follow up with Azure team to check why Extenstion statusus were always returning null in Get-* cmdlet

Testing:
------
Environment: SQLVM created via new Azure portal using ARM

Powershell script used:
-----------------------
Switch-AzureMode -Name AzureResourceManager

$subscriptionName = "__Subscription__"
$vmName = "__vm_name__"
$resourceGroupName = "__resourcegroupName__"


Add-azureaccount
select-azuresubscription -SubscriptionName $subscriptionName

# Get Azure VM created using ARM
$vm = get-azurevm -ResourceGroupName $resourceGroupName -Name $vmName

###########
#Set auto patching
###########
$aps = New-AzureVMSqlServerAutoPatchingConfig -Enable -DayOfWeek "EveryDay" -MaintenanceWindowStartingHour 20 -MaintenanceWindowDuration 120 -PatchCategory "Important"
$vm | Set-AzureVMSqlServerExtension -AutoPatchingSettings $aps  -ResourceGroupName $resourceGroupName -VMName $vmName -Version "1.2" -Verbose

###########
#Set auto backup
###########
$storageUrl = "https://__account__.blob.core.windows.net/"
$storageAccountKey = "__KEY__"
$storageAccountKeySecure = convertto-securestring $storageAccountKey -asplaintext -force

$abs = New-AzureVMSqlServerAutoBackupConfig -Enable -RetentionPeriod 22 -StorageUri $storageUrl -StorageKey $storageAccountKeySecure
$vm = get-azurevm -ResourceGroupName $resourceGroupName -Name $vmName
$vm | Set-AzureVMSqlServerExtension -AutoBackupSettings $abs  -ResourceGroupName $resourceGroupName -VMName $vmName -Version "1.2" -Verbose

###########
#get extension status
###########
Get-AzureVMSqlServerExtension -ResourceGroupName $resourceGroupName -VMName $vmName -Name $vmName

###########
#remove extension
###########
Remove-AzureVMSqlServerExtension -ResourceGroupName $resourceGroupName -VMName $vmName -Name $vmName

Task# 5468533 - SQL IaaS Extension PowerShell Resource Management support

Author: sethusrinivasan

src/ResourceManager/Compute/Commands.Compute/Commands.Compute.csproj

@@ -223,6 +223,17 @@
     <Compile Include="Extension\SetAzureVMExtensionCommand.cs" />
     <Compile Include="Extension\RemoveAzureVMExtensionCommand.cs" />
     <Compile Include="Extension\GetAzureVMExtensionCommand.cs" />
+    <Compile Include="Extension\SqlServer\AzureVMSqlServerAutoBackupSettings.cs" />
+    <Compile Include="Extension\SqlServer\AzureVMSqlServerAutoPatchingSettings.cs" />
+    <Compile Include="Extension\SqlServer\AzureVMSqlServerAutoTelemetrySettings.cs" />
+    <Compile Include="Extension\SqlServer\AzureVMSqlServerPrivateSettings.cs" />
+    <Compile Include="Extension\SqlServer\AzureVMSqlServerPublicSettings.cs" />
+    <Compile Include="Extension\SqlServer\GetAzureVMSqlServerExtensionCommand.cs" />
+    <Compile Include="Extension\SqlServer\NewAzureVMSqlServerAutoBackupConfig.cs" />
+    <Compile Include="Extension\SqlServer\NewAzureVMSqlServerAutoPatchingConfig.cs" />
+    <Compile Include="Extension\SqlServer\RemoveAzureVMSqlServerExtensionCommand.cs" />
+    <Compile Include="Extension\SqlServer\SetAzureVMSqlServerExtensionCommand.cs" />
+    <Compile Include="Extension\SqlServer\VirtualMachineSqlServerExtensionContext.cs" />
     <Compile Include="Images\GetAzureVMImageCommand.cs" />
     <Compile Include="Common\HashTableExtensions.cs" />
     <Compile Include="Models\PSComputeLongRunningOperation.cs" />

src/ResourceManager/Compute/Commands.Compute/Common/ConstantStringTypes.cs

@@ -97,5 +97,8 @@ public static class ProfileNouns
         //DSC
         public const string VirtualMachineDscExtension = "AzureVMDscExtension";
         public const string VirtualMachineDscConfiguration = "AzureVMDscConfiguration";
+
+        // Sql Server
+        public const string VirtualMachineSqlServerExtension = "AzureVMSqlServerExtension";
     }
 }

src/ResourceManager/Compute/Commands.Compute/Extension/SqlServer/AzureVMSqlServerAutoBackupSettings.cs

@@ -0,0 +1,52 @@
+// ----------------------------------------------------------------------------------
+//
+// Copyright Microsoft Corporation
+// 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.
+// ----------------------------------------------------------------------------------
+
+namespace Microsoft.Azure.Commands.Compute
+{
+    /// <summary>
+    /// Autobackup settings to configure managed backup on SQL VM
+    /// </summary>
+    public class AutoBackupSettings
+    {
+        /// <summary>
+        /// Defines if the Auto-backup feature is enabled or disabled
+        /// </summary>
+        public bool Enable { get; set; }
+
+        /// <summary>
+        /// Defines if backups will be encrypted or not
+        /// </summary>
+        public bool EnableEncryption { get; set; }
+
+        /// <summary>
+        /// Defines the number of days to keep the backups
+        /// </summary>
+        public int RetentionPeriod { get; set; }
+
+        /// <summary>
+        /// storage url where databases will be backed up
+        /// </summary>
+        public string StorageUrl { get; set; }
+
+        /// <summary>
+        /// Key of storage account used by managed backup
+        /// </summary>
+        public string StorageAccessKey { get; set; }
+
+        /// <summary>
+        /// Password required for certification when encryption is enabled
+        /// </summary>
+        public string Password { get; set; }
+    }
+}

src/ResourceManager/Compute/Commands.Compute/Extension/SqlServer/AzureVMSqlServerAutoPatchingSettings.cs

@@ -0,0 +1,47 @@
+// ----------------------------------------------------------------------------------
+//
+// Copyright Microsoft Corporation
+// 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.
+// ----------------------------------------------------------------------------------
+
+namespace Microsoft.Azure.Commands.Compute
+{
+    /// <summary>
+    /// AutoPatching settings to configure auto-patching on SQL VM
+    /// </summary>
+    public class AutoPatchingSettings
+    {
+        /// <summary>
+        /// Enable / Disable auto patching
+        /// </summary>
+        public bool Enable { get; set; }
+
+        /// <summary>
+        /// Day of the week
+        /// </summary>
+        public string DayOfWeek { get; set; }
+
+        /// <summary>
+        /// Maintainance Windows Start hour ( 0 to 23 ) 
+        /// </summary>
+        public int MaintenanceWindowStartingHour { get; set; }
+
+        /// <summary>
+        /// Maintainance window duration in minutes
+        /// </summary>
+        public int MaintenanceWindowDuration { get; set; }
+
+        /// <summary>
+        /// Patch category returned as string
+        /// </summary>
+        public string PatchCategory { get; set; }
+    }
+}

src/ResourceManager/Compute/Commands.Compute/Extension/SqlServer/AzureVMSqlServerAutoTelemetrySettings.cs

@@ -0,0 +1,27 @@
+// ----------------------------------------------------------------------------------
+//
+// Copyright Microsoft Corporation
+// 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.
+// ----------------------------------------------------------------------------------
+
+namespace Microsoft.Azure.Commands.Compute
+{
+    /// <summary>
+    /// AutoTelemetry settings to configure telemetry collection on SQL VM
+    /// </summary>
+    public class AutoTelemetrySettings
+    {
+        /// <summary>
+        /// The name of the region the VM is running in.
+        /// </summary>
+        public string Region { get; set; }
+    }
+}

src/ResourceManager/Compute/Commands.Compute/Extension/SqlServer/AzureVMSqlServerPrivateSettings.cs

@@ -0,0 +1,37 @@
+// ----------------------------------------------------------------------------------
+//
+// Copyright Microsoft Corporation
+// 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.
+// ----------------------------------------------------------------------------------
+
+namespace Microsoft.Azure.Commands.Compute
+{
+    /// <summary>
+    /// SQL Server extension's private settings 
+    /// </summary>
+    public class SqlServerPrivateSettings
+    {
+        /// <summary>
+        /// Azure blob store URL
+        /// </summary>
+        public string StorageUrl;
+
+        /// <summary>
+        /// Storage account access key
+        /// </summary>
+        public string StorageAccessKey;
+
+        /// <summary>
+        ///  Password required for certification when encryption is enabled
+        /// </summary>
+        public string Password;
+    }
+}

src/ResourceManager/Compute/Commands.Compute/Extension/SqlServer/AzureVMSqlServerPublicSettings.cs

@@ -0,0 +1,37 @@
+// ----------------------------------------------------------------------------------
+//
+// Copyright Microsoft Corporation
+// 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.
+// ----------------------------------------------------------------------------------
+
+namespace Microsoft.Azure.Commands.Compute
+{
+    /// <summary>
+    /// SQL Server Extension's public settings
+    /// </summary>
+    public class SqlServerPublicSettings
+    {
+        /// <summary>
+        /// Auto patching settings
+        /// </summary>
+        public AutoPatchingSettings AutoPatchingSettings { get; set; }
+
+        /// <summary>
+        /// Auto-backup settings
+        /// </summary>
+        public AutoBackupSettings AutoBackupSettings { get; set; }
+
+        /// <summary>
+        /// Auto-telemetry settings
+        /// </summary>
+        public AutoTelemetrySettings AutoTelemetrySettings { get; set; }
+    }
+}