Updating datasecurity cmdlets help

Updating datasecurity cmdlets help

Author: yaakoviyun

src/ResourceManager/Sql/Commands.Sql/Microsoft.Azure.Commands.Sql.dll-Help.xml

@@ -22,27 +22,41 @@ Get-AzureRmSqlDatabaseAuditingPolicy [-ServerName] <String> [-DatabaseName] <Str
 The **Get-AzureRmSqlDatabaseAuditingPolicy** cmdlet gets the auditing policy of an Azure SQL Database.
 To use the cmdlet, use the *ResourceGroupName*, *ServerName*, and *DatabaseName* parameters to identify the database.
 
-This cmdlet is also supported by the SQL Server Stretch Database service on Azure.
 
 ## EXAMPLES
 
-### Example 1: Get the auditing policy of an Azure SQL database
+### Example 1: Get the auditing policy of an Azure SQL database with Table auditing defined on it
 ```
 PS C:\>Get-AzureRmSqlDatabaseAuditingPolicy -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
-DatabaseName       : database01
-UseServerDefault   : Disabled
-ResourceGroupName  : resourcegroup01
-ServerName         : server01
-StorageAccountName : 
-StorageKeyType     : Primary
-EventType          : {PlainSQL_Success, PlainSQL_Failure, ParameterizedSQL_Success, ParameterizedSQL_Failure...} 
-AuditState         : New
-RetentionInDays    : 0
-TableIdentifier    : Server01Database01
-AuditType          : Table
+DatabaseName           : database01
+UseServerDefault       : Disabled
+EventType              : {PlainSQL_Success, PlainSQL_Failure, ParameterizedSQL_Success, ParameterizedSQL_Failure...} 
+TableIdentifier        : MyAuditTableName
+FullAuditLogsTableName : SQLDBAuditLogsMyAuditTableName
+ResourceGroupName      : resourcegroup01
+ServerName             : server01
+AuditType              : Table
+AuditState             : Enabled
+StorageAccountName     : mystorage
+StorageKeyType         : Primary
+RetentionInDays        : 0
 ```
 
-This command gets the auditing policy of database Database01 located in Server01 in resource group ResourceGroup01.
+### Example 2: Get the auditing policy of an Azure SQL database with Blob auditing defined on it
+```
+PS C:\>Get-AzureRmSqlDatabaseAuditingPolicy -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
+DatabaseName           : database01
+AuditAction            : {}
+AuditActionGroup       : {SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP, FAILED_DATABASE_AUTHENTICATION_GROUP,
+                          BATCH_COMPLETED_GROUP, ...} 
+ResourceGroupName      : resourcegroup01
+ServerName             : server01
+AuditType              : Blob
+AuditState             : Enabled
+StorageAccountName     : mystorage
+StorageKeyType         : Primary
+RetentionInDays        : 0
+```
 
 ## PARAMETERS
 

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

@@ -40,21 +40,6 @@ This command gets the data masking policy from database Database01 in resource g
 
 ## PARAMETERS
 
-### -ServerName
-Specifies the name of the server where the database is located.
-
-```yaml
-Type: String
-Parameter Sets: (All)
-Aliases: 
-
-Required: True
-Position: 1
-Default value: None
-Accept pipeline input: True (ByPropertyName)
-Accept wildcard characters: False
-```
-
 ### -DatabaseName
 Specifies the name of the database.
 
@@ -70,21 +55,6 @@ Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
 ```
 
-### -ResourceGroupName
-Specifies the name of the resource group to which the database is assigned.
-
-```yaml
-Type: String
-Parameter Sets: (All)
-Aliases: 
-
-Required: True
-Position: 0
-Default value: None
-Accept pipeline input: True (ByPropertyName)
-Accept wildcard characters: False
-```
-
 ### -InformationAction
 Specifies how this cmdlet responds to an information event.
 
@@ -124,6 +94,36 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -ResourceGroupName
+Specifies the name of the resource group to which the database is assigned.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+
+Required: True
+Position: 0
+Default value: None
+Accept pipeline input: True (ByPropertyName)
+Accept wildcard characters: False
+```
+
+### -ServerName
+Specifies the name of the server where the database is located.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: True (ByPropertyName)
+Accept wildcard characters: False
+```
+
 ### -Confirm
 Prompts you for confirmation before running the cmdlet.
 

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

@@ -31,14 +31,56 @@ This cmdlet is also supported by the SQL Server Stretch Database service on Azur
 ### Example 1: Get all data masking rules from a database
 ```
 PS C:\>Get-AzureRmSqlDatabaseDataMaskingRule -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
+DatabaseName      : database01
+ResourceGroupName : resourcegroup01
+ServerName        : server01
+SchemaName        : dbo
+TableName         : table1
+ColumnName        : column1
+MaskingFunction   : Default
+PrefixSize        :
+SuffixSize        :
+ReplacementString :
+NumberFrom        :
+NumberTo          :
+
+DatabaseName      : database01
+ResourceGroupName : resourcegroup01
+ServerName        : server01
+SchemaName        : dbo
+TableName         : table2
+ColumnName        : column2
+MaskingFunction   : Default
+PrefixSize        :
+SuffixSize        :
+ReplacementString :
+NumberFrom        :
+NumberTo          :
+
 ```
 
-This command gets all data masking rules from Database01 in resource group ResourceGroup01 found on server Server01.
+
+### Example 2: Get the data masking rule defined on schema "dbo", table "table1" and column "column1".
+```
+PS C:\>Get-AzureRmSqlDatabaseDataMaskingRule -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -SchemaName "dbo" -TableName  "table1" -ColumnName "column1"
+DatabaseName      : database01
+ResourceGroupName : resourcegroup01
+ServerName        : server01
+SchemaName        : dbo
+TableName         : table1
+ColumnName        : column1
+MaskingFunction   : Default
+PrefixSize        :
+SuffixSize        :
+ReplacementString :
+NumberFrom        :
+NumberTo          :
+```
 
 ## PARAMETERS
 
-### -SchemaName
-Specifies the name of a schema.
+### -ColumnName
+Specifies the name of the column targeted by the masking rule.
 
 ```yaml
 Type: String
@@ -52,117 +94,117 @@ Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
 ```
 
-### -TableName
-Specifies the name of an Azure SQL table.
+### -DatabaseName
+Specifies the name of the database.
 
 ```yaml
 Type: String
 Parameter Sets: (All)
 Aliases: 
 
-Required: False
-Position: Named
+Required: True
+Position: 2
 Default value: None
 Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
 ```
 
-### -ColumnName
-Specifies the name of the column targeted by the masking rule.
+### -InformationAction
+Specifies how this cmdlet responds to an information event.
+
+The acceptable values for this parameter are:
+
+- Continue
+- Ignore
+- Inquire
+- SilentlyContinue
+- Stop
+- Suspend
 
 ```yaml
-Type: String
+Type: ActionPreference
 Parameter Sets: (All)
-Aliases: 
+Aliases: infa
 
 Required: False
 Position: Named
 Default value: None
-Accept pipeline input: True (ByPropertyName)
+Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -ServerName
-Specifies the name of the server.
+### -InformationVariable
+Specifies an information variable.
 
 ```yaml
 Type: String
 Parameter Sets: (All)
-Aliases: 
+Aliases: iv
 
-Required: True
-Position: 1
+Required: False
+Position: Named
 Default value: None
-Accept pipeline input: True (ByPropertyName)
+Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -DatabaseName
-Specifies the name of the database.
+### -ResourceGroupName
+Specifies the name of the resource group to which the database is assigned.
 
 ```yaml
 Type: String
 Parameter Sets: (All)
 Aliases: 
 
 Required: True
-Position: 2
+Position: 0
 Default value: None
 Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
 ```
 
-### -ResourceGroupName
-Specifies the name of the resource group to which the database is assigned.
+### -SchemaName
+Specifies the name of a schema.
 
 ```yaml
 Type: String
 Parameter Sets: (All)
 Aliases: 
 
-Required: True
-Position: 0
+Required: False
+Position: Named
 Default value: None
 Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
 ```
 
-### -InformationAction
-Specifies how this cmdlet responds to an information event.
-
-The acceptable values for this parameter are:
-
-- Continue
-- Ignore
-- Inquire
-- SilentlyContinue
-- Stop
-- Suspend
+### -ServerName
+Specifies the name of the server.
 
 ```yaml
-Type: ActionPreference
+Type: String
 Parameter Sets: (All)
-Aliases: infa
+Aliases: 
 
-Required: False
-Position: Named
+Required: True
+Position: 1
 Default value: None
-Accept pipeline input: False
+Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
 ```
 
-### -InformationVariable
-Specifies an information variable.
+### -TableName
+Specifies the name of an Azure SQL table.
 
 ```yaml
 Type: String
 Parameter Sets: (All)
-Aliases: iv
+Aliases: 
 
 Required: False
 Position: Named
 Default value: None
-Accept pipeline input: False
+Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
 ```