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 Number ou Text para MaskingFunction, poderá especificar os parâmetros NumberFrom e NumberTo para mascaramento de número ou os parâmetros PrefixSize, ReplacementString e SuffixSize para mascaramento de texto. Se o comando for bem-sucedido e se você especificar o parâmetro PassThru , o cmdlet retornará um objeto que descreve as propriedades da regra de mascaramento de dados e os identificadores da regra. Os identificadores de regra incluem, mas não estão limitados a, ResourceGroupName, ServerName, DatabaseName e RuleId. Esse cmdlet também é suportado pelo serviço SQL Server Stretch Database no Azure.

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"

Este comando modifica uma regra de mascaramento de dados que tem a ID Rule17. Essa regra opera no banco de dados chamado Database01 no servidor Server01. Este comando altera os limites para o intervalo no qual um número aleatório é gerado como o valor mascarado. A nova gama situa-se entre os 23 e os 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 a 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 usada pela regra. Os valores aceitáveis para este parâmetro são:

  • Predefinido
  • Não-mascaramento
  • 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 predefinido é 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 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 predefinido é 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 o qual você está trabalhando. Por padrão, esse cmdlet não gera nenhuma 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 predefinido é 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 predefinido é 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 predefinido é 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 do 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

Apresenta o que aconteceria mediante a execução do cmdlet. 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