Add migration guide for Stack AzureRm 1.2.11

Author: viananth

documentation/release-notes/Stack/migration-guide.1.2.11.md

@@ -0,0 +1,117 @@
+# Table of Contents
+1. [Removal of Force parameters](#removal-of-force-parameters)
+2. [Change of Tag parameters](#change-of-tag-parameters)
+
+## Removal of Force parameters
+
+This release, we removed all Obsolete `Force` parameters from cmdlets and the corresponding warnings that the parameter would be removed in a future release.
+
+The following cmdlets are affected by this change:
+
+**Profile**
+- Remove-AzureRmEnvironment
+
+**Resources**
+- Register-AzureRmProviderFeature
+- Register-AzureRmResourceProvider
+- Remove-AzureRmADServicePrincipal
+- Remove-AzureRmPolicyAssignment
+- Remove-AzureRmResourceGroupDeployment
+- Remove-AzureRmRoleAssignment
+- Stop-AzureRmResourceGroupDeployment
+- Unregister-AzureRmResourceProvider
+
+**Tag**
+- Remove-AzureRmTag
+
+<br>
+
+If you have a script that uses any of the above cmdlets, the breaking change can be fixed by simply removing the `Force` parameter.
+
+```powershell
+# Old
+New-AzureRmResourceGroup -Name $resourceGroupName -Location $location -Force
+
+# New
+New-AzureRmResourceGroup -Name $resourceGroupName -Location $location
+```
+
+<br>
+
+## Change of Tag parameters
+
+This release, the `Tags` parameter name was changed to `Tag`, and the type was changed from `Hashtable[]` to `Hashtable`, changing the format of the key-value pairings.
+
+Previously, each entry in the `Hashtable[]` represented a single key-value pairing:
+
+```powershell
+$tags = @{ Name = "test1"; Value = "testval1" }, @{ Name = "test2", Value = "testval2" }
+$tags[0].Name  # Key for the first entry, "test1"
+$tags[0].Value # Value for the first entry, "testval1"
+$tags[1].Name  # Key for the second entry, "test2"
+$tags[1].Value # Value for the second entry, "testval2"
+```
+
+Now, `Name` and `Value` are no longer necessary, allowing for key-value pairings to be created by assigning `Key = "Value"` in the `Hashtable`:
+
+```powershell
+$tag = @{ test1 = "testval1"; test2 = "testval2" }
+$tag["test1"] # Gets the value associated with the key "test1"
+$tag["test2"] # Gets the value associated with the key "test2"
+```
+
+The following cmdlets are affected by this change:
+
+
+**Compute**
+- New-AzureRmVM
+- Update-AzureRmVM
+
+**Dns**
+- New-AzureRmDnsZone
+- Set-AzureRmDnsZone
+
+**KeyVault**
+- Get-AzureRmKeyVault
+- New-AzureRmKeyVault
+
+**Network**
+- New-AzureRmApplicationGateway
+- New-AzureRmExpressRouteCircuit
+- New-AzureRmLoadBalancer
+- New-AzureRmLocalNetworkGateway
+- New-AzureRmNetworkInterface
+- New-AzureRmNetworkSecurityGroup
+- New-AzureRmPublicIpAddress
+- New-AzureRmRouteTable
+- New-AzureRmVirtualNetwork
+- New-AzureRmVirtualNetworkGateway
+- New-AzureRmVirtualNetworkGatewayConnection
+- New-AzureRmVirtualNetworkPeering
+
+**Resources**
+- Find-AzureRmResource
+- Find-AzureRmResourceGroup
+- New-AzureRmResource
+- New-AzureRmResourceGroup
+- Set-AzureRmResource
+- Set-AzureRmResourceGroup
+
+**Storage**
+- New-AzureRmStorageAccount
+- Set-AzureRmStorageAccount
+
+
+<br>
+
+If you have a script that uses any of the above cmdlets, the breaking change can be fixed by changing the `Tags` parameter to `Tag`, as well as changing the `Tag` to the new format.
+
+```powershell
+# Old
+New-AzureRmResourceGroup -Name $resourceGroupName -Location -location -Tags @{ Name = "testtag"; Value = "testval" }
+
+# New
+New-AzureRmResourceGroup -Name $resourceGroupName -Location -location -Tag @{ testtag = "testval" }
+```
+
+