Set-AzSqlDatabaseDataMaskingRule

Define as propriedades de uma regra de mascaramento de dados para um banco de dados.

Syntax

Set-AzSqlDatabaseDataMaskingRule
   [-MaskingFunction <String>]
   [-PrefixSize <UInt32>]
   [-ReplacementString <String>]
   [-SuffixSize <UInt32>]
   [-NumberFrom <Double>]
   [-NumberTo <Double>]
   [-PassThru]
   -SchemaName <String>
   -TableName <String>
   -ColumnName <String>
   [-ServerName] <String>
   [-DatabaseName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-AzSqlDatabaseDataMaskingRule define uma regra de mascaramento de dados para um banco de dados SQL do Azure. Para usar o cmdlet, forneça os parâmetros ResourceGroupName, ServerName, DatabaseName e RuleId para identificar a regra. Você pode fornecer qualquer um dos parâmetros de SchemaName, TableName e ColumnName para redirecionar a regra. Especifique o parâmetro MaskingFunction para modificar como os dados são mascarados. Se você especificar um valor de número ou texto para MaskingFunction, poderá especificar os parâmetros NumberFrom e NumberTo para o mascaramento de números ou os parâmetros PrefixSize, ReplacementString e SuffixSize para mascaramento de texto. Se o comando for bem-sucedido e você especificar o parâmetro PassThru, o cmdlet retornará um objeto que descreve as propriedades da regra de mascaramento de dados e os identificadores de regra. Os identificadores de regra incluem, mas não estão limitados a, ResourceGroupName, ServerName, DatabaseName e RuleId. O serviço de SQL Server Stretch Database no Azure também dá suporte a esse cmdlet.

Exemplos

Exemplo 1: Alterar o intervalo de uma regra de mascaramento de dados em um banco de dados

Set-AzSqlDatabaseDataMaskingRule -ResourceGroupName $params.rgname -ServerName $params.serverName  -DatabaseName $params.databaseName -SchemaName "dbo" -TableName  "table1" -ColumnName "column1" -MaskingFunction "Default"

Esse comando modifica uma regra de mascaramento de dados que tem a regra de ID17. Essa regra opera no banco de dados chamado Database01 no servidor Server01. Esse comando altera os limites do intervalo no qual um número aleatório é gerado como o valor mascarado. A nova faixa fica entre 23 e 42.

Exemplo 2

Define as propriedades de uma regra de mascaramento de dados para um banco de dados. (gerado automaticamente)

Set-AzSqlDatabaseDataMaskingRule -ColumnName 'column1' -DatabaseName $params.databaseName -MaskingFunction NoMasking -NumberFrom 5 -NumberTo 14 -PrefixSize <UInt32> -ReplacementString <String> -ResourceGroupName $params.rgname -SchemaName 'dbo' -ServerName $params.serverName -SuffixSize <UInt32> -TableName 'table1'

Parâmetros

-ColumnName

Especifica o nome da coluna direcionada pela regra de mascaramento.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseName

Especifica o nome do banco de dados.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaskingFunction

Especifica a função de mascaramento que a regra usa. Os valores aceitáveis para esse parâmetro são:

  • Padrão
  • NãoMascaramento
  • Texto
  • Número
  • Número de Segurança Social
  • Número do Cartão de Crédito
  • Email O valor padrão é Default.
Type:String
Accepted values:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NumberFrom

Especifica o número de limite inferior do intervalo a partir do qual um valor aleatório é selecionado. Especifique esse parâmetro somente se você especificar um valor de Number para o parâmetro MaskingFunction . O valor padrão é 0.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NumberTo

Especifica o número de limite superior do intervalo a partir do qual um valor aleatório é selecionado. Especifique esse parâmetro somente se você especificar um valor de Number para o parâmetro MaskingFunction . O valor padrão é 0.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Retorna um objeto que representa o item com que você está trabalhando. Por padrão, este cmdlet não gera saída.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrefixSize

Especifica o número de caracteres no início do texto que não estão mascarados. Especifique esse parâmetro somente se você especificar um valor de Text para o parâmetro MaskingFunction . O valor padrão é 0.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ReplacementString

Especifica o número de caracteres no final do texto que não estão mascarados. Especifique esse parâmetro somente se você especificar um valor de Text para o parâmetro MaskingFunction . O valor padrão é 0.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Especifica o nome do grupo de recursos ao qual o banco de dados está atribuído.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SchemaName

Especifica o nome de um esquema.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServerName

Especifica o nome do servidor que hospeda o banco de dados.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SuffixSize

Especifica o número de caracteres no final do texto que não estão mascarados. Especifique esse parâmetro somente se você especificar um valor de Text para o parâmetro MaskingFunction . O valor padrão é 0.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TableName

Especifica o nome da tabela de banco de dados que contém a coluna mascarada.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Nullable<T>[[System.UInt32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[System.Double, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Saídas

DatabaseDataMaskingRuleModel