[Draft] Deployment stacks preview 2 to master

NuGet.Config

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <configuration>
   <packageSources>
-    <clear />
+    <clear/>
     <!-- Do not add any additional feeds if new packages are needed they need to come from nuget.org or our azure-sdk-for-net DevOps feed -->
     <add key="local-feed" value="tools/LocalFeed" />
     <add key="azure-powershell" value="https://pkgs.dev.azure.com/azclitools/public/_packaging/azure-powershell/nuget/v3/index.json" />

src/Resources/ResourceManager/Components/ResourceIdentifier.cs

@@ -31,6 +31,8 @@ public class ResourceIdentifier
 
         public string Subscription { get; set; }
 
+        public string ManagementGroupName { get; set; }
+
         public ResourceIdentifier() { }
 
         public ResourceIdentifier(string idFromServer)

src/Resources/ResourceManager/Implementation/CmdletBase/DeploymentStacksCmdletBase.cs

@@ -0,0 +1,100 @@
+using Microsoft.Azure.Commands.Common.Authentication.Abstractions;
+using Microsoft.Azure.Commands.ResourceManager.Cmdlets.SdkClient;
+using Microsoft.Azure.Commands.ResourceManager.Cmdlets.Utilities;
+using Microsoft.WindowsAzure.Commands.Utilities.Common;
+using System.Collections;
+
+namespace Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation
+{
+    public abstract class DeploymentStacksCmdletBase : ResourceManagerCmdletBase
+    {
+
+        /// <summary>
+        /// Deployment stacks client instance field
+        /// </summary>
+        private DeploymentStacksSdkClient deploymentStacksSdkClient;
+
+        /// <summary>
+        /// Gets or sets the deployment stacks sdk client
+        /// </summary>
+        public DeploymentStacksSdkClient DeploymentStacksSdkClient
+        {
+            get
+            {
+                if (this.deploymentStacksSdkClient == null)
+                {
+                    this.deploymentStacksSdkClient = new DeploymentStacksSdkClient(DefaultContext);
+                }
+
+                this.deploymentStacksSdkClient.VerboseLogger = WriteVerboseWithTimestamp;
+                this.deploymentStacksSdkClient.ErrorLogger = WriteErrorWithTimestamp;
+                this.deploymentStacksSdkClient.WarningLogger = WriteWarningWithTimestamp;
+
+                return this.deploymentStacksSdkClient;
+            }
+
+            set
+            {
+                this.deploymentStacksSdkClient = value;
+            }
+        }
+
+        protected string ResolveBicepFile(string TemplateFile)
+        {
+            string filePath = "";
+            if (BicepUtility.IsBicepFile(TemplateFile))
+            {
+                filePath = BicepUtility.BuildFile(this.ResolvePath(TemplateFile), this.WriteVerbose, this.WriteWarning);
+                return filePath;
+            }
+            else
+                return TemplateFile;
+
+        }
+
+        protected Hashtable GetParameterObject(string parameterFile)
+        {
+            var parameters = new Hashtable();
+            string templateParameterFilePath = this.ResolvePath(parameterFile);
+            if (parameterFile != null && FileUtilities.DataStore.FileExists(templateParameterFilePath))
+            {
+                var parametersFromFile = TemplateUtility.ParseTemplateParameterFileContents(templateParameterFilePath);
+                parametersFromFile.ForEach(dp =>
+                {
+                    var parameter = new Hashtable();
+                    if (dp.Value.Value != null)
+                    {
+                        parameter.Add("value", dp.Value.Value);
+                    }
+                    if (dp.Value.Reference != null)
+                    {
+                        parameter.Add("reference", dp.Value.Reference);
+                    }
+
+                    parameters[dp.Key] = parameter;
+                });
+            }
+            return parameters;
+        }
+
+        protected Hashtable GetTemplateParameterObject(Hashtable templateParameterObject)
+        {
+            //create a new Hashtable so that user can re-use the templateParameterObject.
+            var parameterObject = new Hashtable();
+            foreach (var parameterKey in templateParameterObject.Keys)
+            {
+                // Let default behavior of a value parameter if not a KeyVault reference Hashtable
+                var hashtableParameter = templateParameterObject[parameterKey] as Hashtable;
+                if (hashtableParameter != null && hashtableParameter.ContainsKey("reference"))
+                {
+                    parameterObject[parameterKey] = templateParameterObject[parameterKey];
+                }
+                else
+                {
+                    parameterObject[parameterKey] = new Hashtable { { "value", templateParameterObject[parameterKey] } };
+                }
+            }
+            return parameterObject;
+        }
+    }
+}

src/Resources/ResourceManager/Implementation/DeploymentStacks/ExportAzManagmentGroupDeploymentStackTemplate.cs

@@ -0,0 +1,83 @@
+// ----------------------------------------------------------------------------------
+//
+// 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.ResourceManager.Cmdlets.Implementation
+{
+    using Microsoft.Azure.Commands.ResourceManager.Cmdlets.Components;
+    using Microsoft.Azure.Commands.ResourceManager.Cmdlets.SdkClient;
+    using Microsoft.Azure.Commands.ResourceManager.Cmdlets.SdkModels;
+    using System;
+    using System.Management.Automation;
+
+    [Cmdlet("Export", Common.AzureRMConstants.AzureRMPrefix + "ManagementGroupDeploymentStackTemplate",
+        DefaultParameterSetName = ExportByNameAndManagementGroupIdParameterSetName), OutputType(typeof(PSDeploymentStackTemplateDefinition))]
+    public class ExportAzManagementGroupDeploymentStackTemplate : DeploymentStacksCmdletBase
+    {
+        #region Cmdlet Parameters and Parameter Set Definitions
+
+        internal const string ExportByResourceIdParameterSetName = "ExportByResourceId";
+        internal const string ExportByNameAndManagementGroupIdParameterSetName = "ExportByNameAndManagmentGroupId";
+
+        [Alias("Id")]
+        [Parameter(Mandatory = true, ValueFromPipelineByPropertyName = true, ParameterSetName = ExportByResourceIdParameterSetName, 
+            HelpMessage = "ResourceId of the DeploymentStack to get")]
+        [ValidateNotNullOrEmpty]
+        public string ResourceId { get; set; }
+
+        [Alias("StackName")]
+        [Parameter(Position = 1, Mandatory = true, ValueFromPipelineByPropertyName = true, ParameterSetName = ExportByNameAndManagementGroupIdParameterSetName, 
+            HelpMessage = "The name of the DeploymentStack to get")]
+        [ValidateNotNullOrEmpty]
+        public string Name { get; set; }
+
+        [Parameter(Position = 0, Mandatory = true, ValueFromPipelineByPropertyName = true, ParameterSetName = ExportByNameAndManagementGroupIdParameterSetName,
+            HelpMessage = "The id of the ManagementGroup where the DeploymentStack is deployed")]
+        [ValidateNotNullOrEmpty]
+        public string ManagementGroupId { get; set; }
+
+        #endregion
+
+        #region Cmdlet Overrides
+        protected override void OnProcessRecord()
+        {
+            try
+            {
+                switch (ParameterSetName)
+                {
+                    case ExportByResourceIdParameterSetName:
+                        ManagementGroupId = ResourceIdUtility.GetManagementGroupId(ResourceId);
+                        Name = ResourceIdUtility.GetDeploymentName(ResourceId);
+                        if (ManagementGroupId == null || Name == null)
+                        {
+                            throw new PSArgumentException($"Provided Id '{ResourceId}' is not in correct form. Should be in form " +
+                                "/providers/Microsoft.Management/managementGroups/<managementgroupid>/providers/Microsoft.Resources/deploymentStacks/<stackname>");
+                        }
+                        WriteObject(DeploymentStacksSdkClient.ExportManagementGroupDeploymentStack(ManagementGroupId, Name), true);
+                        break;
+                    case ExportByNameAndManagementGroupIdParameterSetName:
+                        WriteObject(DeploymentStacksSdkClient.ExportManagementGroupDeploymentStack(ManagementGroupId, Name), true);
+                        break;
+                    default:
+                        throw new PSInvalidOperationException();
+                }
+            }
+            catch (Exception ex)
+            {
+                WriteExceptionError(ex);
+            }
+        }
+
+        #endregion
+    }
+}

src/Resources/ResourceManager/Implementation/DeploymentStacks/ExportAzResourceGroupDeploymentStackTemplate.cs

@@ -0,0 +1,85 @@
+// ----------------------------------------------------------------------------------
+//
+// 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.ResourceManager.Cmdlets.Implementation
+{
+    using Microsoft.Azure.Commands.ResourceManager.Cmdlets.Components;
+    using Microsoft.Azure.Commands.ResourceManager.Cmdlets.SdkModels;
+    using Microsoft.Azure.Commands.ResourceManager.Common.ArgumentCompleters;
+    using System;
+    using System.Management.Automation;
+
+    [Cmdlet("Export", Common.AzureRMConstants.AzureRMPrefix + "ResourceGroupDeploymentStackTemplate",
+        DefaultParameterSetName = ExportByNameAndResourceGroupNameParameterSetName), OutputType(typeof(PSDeploymentStackTemplateDefinition))]
+    public class ExportAzResourceGroupDeploymentStackTemplate : DeploymentStacksCmdletBase
+    {
+        #region Cmdlet Parameters and Parameter Set Definitions
+
+        internal const string ExportByResourceIdParameterSetName = "ExportByResourceId";
+        internal const string ExportByNameAndResourceGroupNameParameterSetName = "ExportByNameAndResourceGroupName";
+
+        [Alias("Id")]
+        [Parameter(Mandatory = true, ValueFromPipelineByPropertyName = true, ParameterSetName = ExportByResourceIdParameterSetName,
+             HelpMessage = "ResourceId of the DeploymentStack to get")]
+        [ValidateNotNullOrEmpty]
+        public string ResourceId { get; set; }
+
+        [Parameter(Position = 0, Mandatory = true, ValueFromPipelineByPropertyName = true, ParameterSetName = ExportByNameAndResourceGroupNameParameterSetName,
+             HelpMessage = "The name of the ResourceGroup where the DeploymentStack is deployed")]
+        [ResourceGroupCompleter]
+        [ValidateNotNullOrEmpty]
+        public string ResourceGroupName { get; set; }
+
+        [Alias("StackName")]
+        [Parameter(Position = 1, Mandatory = true, ValueFromPipelineByPropertyName = true, ParameterSetName = ExportByNameAndResourceGroupNameParameterSetName,
+             HelpMessage = "The name of the DeploymentStack to get")]
+        [ValidateNotNullOrEmpty]
+        public string Name { get; set; }
+
+        #endregion
+
+        #region Cmdlet Overrides
+
+        protected override void OnProcessRecord()
+        {
+            try
+            {
+                switch (ParameterSetName)
+                {
+                    case ExportByResourceIdParameterSetName:
+                        ResourceGroupName = ResourceIdUtility.GetResourceGroupName(ResourceId);
+                        Name = ResourceIdUtility.GetDeploymentName(ResourceId);
+                        if (ResourceGroupName == null || Name == null)
+                        {
+                            throw new PSArgumentException($"Provided Id '{ResourceId}' is not in correct form. Should be in form " + 
+                                "/subscriptions/<subid>/resourceGroups/<rgname>/providers/Microsoft.Resources/deploymentStacks/<stackname>");
+                        }
+                        WriteObject(DeploymentStacksSdkClient.ExportResourceGroupDeploymentStack(ResourceGroupName, Name), true);
+                        break;
+                    case ExportByNameAndResourceGroupNameParameterSetName:
+                        WriteObject(DeploymentStacksSdkClient.ExportResourceGroupDeploymentStack(ResourceGroupName, Name), true);
+                        break;
+                    default:
+                        throw new PSInvalidOperationException();
+                }
+            }
+            catch (Exception ex)
+            {
+                WriteExceptionError(ex);
+            }
+        }
+
+        #endregion
+    }
+}

src/Resources/ResourceManager/Implementation/DeploymentStacks/ExportAzSubscriptionDeploymentStackTemplate.cs

@@ -0,0 +1,77 @@
+// ----------------------------------------------------------------------------------
+//
+// 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.ResourceManager.Cmdlets.Implementation
+{
+
+    using Microsoft.Azure.Commands.ResourceManager.Cmdlets.Components;
+    using Microsoft.Azure.Commands.ResourceManager.Cmdlets.SdkModels;
+    using System;
+    using System.Management.Automation;
+
+    [Cmdlet("Export", Common.AzureRMConstants.AzureRMPrefix + "SubscriptionDeploymentStackTemplate",
+        DefaultParameterSetName = ExportByNameParameterSetName), OutputType(typeof(PSDeploymentStackTemplateDefinition))]
+    public class ExportAzSubscriptionDeploymentStackTemplate : DeploymentStacksCmdletBase
+    {
+        #region Cmdlet Parameters and Parameter Set Definitions
+
+        internal const string ExportByResourceIdParameterSetName = "ExportByResourceId";
+        internal const string ExportByNameParameterSetName = "ExportByName";
+
+        [Alias("Id")]
+        [Parameter(Mandatory = true, ValueFromPipelineByPropertyName = true, ParameterSetName = ExportByResourceIdParameterSetName,
+            HelpMessage = "ResourceId of the DeploymentStack to get")]
+        [ValidateNotNullOrEmpty]
+        public string ResourceId { get; set; }
+
+        [Alias("StackName")]
+        [Parameter(Position = 0, Mandatory = true, ValueFromPipelineByPropertyName = true, ParameterSetName = ExportByNameParameterSetName,
+            HelpMessage = "The name of the DeploymentStack to get")]
+        [ValidateNotNullOrEmpty]
+        public string Name { get; set; }
+
+        #endregion
+
+        #region Cmdlet Overrides
+        protected override void OnProcessRecord()
+        {
+            try
+            {
+                switch (ParameterSetName)
+                {
+                    case ExportByResourceIdParameterSetName:
+                        Name = ResourceIdUtility.GetDeploymentName(ResourceId);
+                        if (Name == null)
+                        {
+                            throw new PSArgumentException($"Provided Id '{ResourceId}' is not in correct form. Should be in form " +
+                                "/subscriptions/<subid>/providers/Microsoft.Resources/deploymentStacks/<stackname>");
+                        }
+                        WriteObject(DeploymentStacksSdkClient.ExportSubscriptionDeploymentStack(Name), true);
+                        break;
+                    case ExportByNameParameterSetName:
+                        WriteObject(DeploymentStacksSdkClient.ExportSubscriptionDeploymentStack(Name), true);
+                        break;
+                    default:
+                        throw new PSInvalidOperationException();
+                }
+            }
+            catch (Exception ex)
+            {
+                WriteExceptionError(ex);
+            }
+        }
+
+        #endregion
+    }
+}