addressing PR comments

- fixed bad formatting caused by bug in platyPS
- Updated help documentation

Author: akromm-zz

src/ResourceManager/Sql/ChangeLog.md

@@ -21,7 +21,7 @@
 * Added Location Completer to -Location parameters allowing tab completion through valid Locations
 * Added ResourceGroup Completer to -ResourceGroup parameters allowing tab completion through resource groups in current subscription
 * Added -AsJob parameter to long running cmdlets
-* removed -DatabaseName parameter from Get-AzureRmSqlServiceObjective
+* Obsoleted -DatabaseName parameter from Get-AzureRmSqlServiceObjective
 
 ## Version 4.1.1
 * Added ability to rename database using Set-AzureRmSqlDatabase

src/ResourceManager/Sql/Commands.Sql/ServiceObjective/Cmdlet/AzureSqlServerServiceObjectiveCmdletBase.cs

@@ -47,7 +47,7 @@ public abstract class AzureSqlServerServiceObjectiveCmdletBase
             HelpMessage = "SQL Database name.",
             DontShow = true)]
         [ValidateNotNullOrEmpty]
-        [Obsolete("This parameter is not needed or used. It will be removed in a future release.")]
+        [Obsolete("This parameter is not needed or used. It will be removed in the next breaking change release.")]
         public string DatabaseName { get; set; }
 
         /// <summary>

src/ResourceManager/Sql/Commands.Sql/help/Add-AzureRmSqlServerKeyVaultKey.md

@@ -41,7 +41,8 @@ CreationDate      : 1/1/2017 12:00:00 AM
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/Get-AzureRmSqlServerServiceObjective.md

@@ -15,8 +15,8 @@ Gets service objectives for an Azure SQL Database server.
 
 ```
 Get-AzureRmSqlServerServiceObjective [[-ServiceObjectiveName] <String>] [-ServerName] <String>
- [-ResourceGroupName] <String> [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm]
- [<CommonParameters>]
+ [[-DatabaseName] <String>] [-ResourceGroupName] <String> [-DefaultProfile <IAzureContextContainer>] [-WhatIf]
+ [-Confirm] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -49,6 +49,20 @@ This command gets the service objectives for the server named Server01 and the d
 
 ## PARAMETERS
 
+### -DatabaseName
+SQL Database name.
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: True (ByPropertyName)
+Accept wildcard characters: False
+```
+
 ### -DefaultProfile
 The credentials, account, tenant, and subscription used for communication with azure
 

src/ResourceManager/Sql/Commands.Sql/help/New-AzureRmSqlDatabase.md

@@ -81,7 +81,8 @@ This command creates a database named Database01 in the elastic pool named Elast
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/New-AzureRmSqlDatabaseCopy.md

@@ -39,7 +39,8 @@ This cmdlet is also supported by the SQL Server Stretch Database service on Azur
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/New-AzureRmSqlDatabaseSecondary.md

@@ -57,7 +57,8 @@ Accept wildcard characters: False
 ```
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/New-AzureRmSqlElasticPool.md

@@ -52,7 +52,8 @@ in. The command specifies DTU property values for the pool and the databases in
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/New-AzureRmSqlServer.md

@@ -41,7 +41,8 @@ This command creates a version 12 Azure SQL Database server.
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/New-AzureRmSqlServerCommunicationLink.md

@@ -37,7 +37,8 @@ This command creates a link named Link01 between ContosoServer17 and ContosoServ
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/New-AzureRmSqlServerDisasterRecoveryConfiguration.md

@@ -33,7 +33,8 @@ The **New-AzureRmSqlServerDisasterRecoveryConfiguration** cmdlet creates a SQL d
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/New-AzureRmSqlServerDnsAlias.md

@@ -36,7 +36,8 @@ This command creates Azure SQL Server DNS Alias with the name aliasName that is
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/New-AzureRmSqlServerVirtualNetworkRule.md

@@ -33,7 +33,8 @@ Creates an Azure SQL Server virtual network rule
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/Remove-AzureRmSqlServerDnsAlias.md

@@ -45,7 +45,8 @@ Removes Azure SQL Server DNS Alias with the name aliasName from the server with
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/Remove-AzureRmSqlServerKeyVaultKey.md

@@ -47,7 +47,8 @@ CreationDate      : 1/1/2017 12:00:00 AM
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/Remove-AzureRmSqlServerVirtualNetworkRule.md

@@ -33,7 +33,8 @@ Deletes an existing Azure SQL Server virtual network rule
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/Restore-AzureRmSqlDatabase.md

@@ -104,7 +104,8 @@ The second command restores the backup in $GeoBackup to the SQL database named R
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/Resume-AzureRmSqlDatabase.md

@@ -33,7 +33,8 @@ This command resumes a suspended Azure SQL Data Warehouse database.
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/Set-AzureRmSqlDatabase.md

@@ -88,7 +88,8 @@ This command adds a database named Database01 to the elastic pool named ElasticP
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/Set-AzureRmSqlDatabaseSecondary.md

@@ -59,7 +59,8 @@ Accept wildcard characters: False
 ```
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/Set-AzureRmSqlElasticPool.md

@@ -72,7 +72,8 @@ storage for an elastic pool to 2 TB.
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/Set-AzureRmSqlServerDnsAlias.md

@@ -35,7 +35,8 @@ This command is updating alias which was previously pointing to oldServer to poi
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/Set-AzureRmSqlServerTransparentDataEncryptionProtector.md

@@ -49,7 +49,8 @@ ContosoResourceGroup ContosoServer AzureKeyVault contoso_contosokey_012345678901
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/Set-AzureRmSqlServerVirtualNetworkRule.md

@@ -36,7 +36,8 @@ Modifies an existing virtual network rule with the new virtual network subnet id
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/Suspend-AzureRmSqlDatabase.md

@@ -33,7 +33,8 @@ This command suspends an active Azure SQL Data Warehouse database.
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/Commands.Sql/help/Switch-AzureRmSqlDatabaseFailoverGroup.md

@@ -57,7 +57,8 @@ Accept wildcard characters: False
 ```
 
 ### -AsJob
-Run cmdlet in the background```yaml
+Run cmdlet in the background
+```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:

src/ResourceManager/Sql/documentation/current-breaking-changes.md

@@ -40,11 +40,6 @@
 
 ## Current Breaking Changes
 
-The following cmdlets were affected this release:
-
-**Get-AzureRmSqlServiceObjective**
-- Database name parameter was removed. It was not needed or used.
-
 **New-AzureRmSqlDatabaseFailoverGroup**
 - Tag parameter was removed
 - 'GracePeriodWithDataLossHour' parameter was renamed to 'GracePeriodWithDataLossHours'