Compartilhar via

New-AzSqlDatabaseDataMaskingRule

  • Referência
Módulo:
Az.Sql

Cria uma regra de mascaramento de dados para um banco de dados.

Sintaxe

New-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 New-AzSqlDatabaseDataMaskingRule cria uma regra de mascaramento de dados para um banco de dados SQL do Azure. Para usar o cmdlet, use os parâmetros ResourceGroupName, ServerNamee DatabaseName para identificar a regra. Forneça o TableName e ColumnName para especificar o destino da regra e o parâmetro MaskingFunction para definir como os dados são mascarados. Se MaskingFunction tiver um valor de Número ou Texto, você poderá especificar os parâmetros NumberFrom e NumberTo, para mascaramento de número ou o PrefixSize, ReplacementStringe SuffixSize para mascaramento de texto. Se o comando for bem-sucedido e o parâmetro PassThru for usado, o cmdlet retornará um objeto que descreve as propriedades da regra de mascaramento de dados além dos identificadores de regra. Os identificadores de regra incluem, mas não se limitam a, ResourceGroupName, ServerName, DatabaseNamee RuleID. Esse cmdlet também é compatível com o serviço SQL Server Stretch Database no Azure.

Exemplos

Exemplo 1: criar uma regra de mascaramento de dados para uma coluna numérica em um banco de dados

New-AzSqlDatabaseDataMaskingRule -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"  -SchemaName "Schema01" -TableName "Table01" -ColumnName "Column01" -MaskingFunction "Number" -NumberFrom 5 -NumberTo 14

Esse comando cria uma regra de mascaramento de dados para a coluna chamada Column01 na tabela chamada Table01 no esquema chamado Schema01. O banco de dados chamado Database01 contém todos esses itens. A regra é uma regra de mascaramento de número que usa um número aleatório entre 5 e 14 como o valor da máscara.

Parâmetros

-ColumnName

Especifica o nome da coluna direcionada pela regra de mascaramento.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DatabaseName

Especifica o nome do banco de dados.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaskingFunction

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

  • Inadimplência
  • NoMasking
  • Texto
  • Número
  • SocialSecurityNumber
  • CreditCardNumber
  • Email O valor padrão é Padrão.
Tipo:String
Valores aceitos:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NumberFrom

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

Tipo:Nullable<T>[Double]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NumberTo

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

Tipo:Nullable<T>[Double]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PrefixSize

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

Tipo:Nullable<T>[UInt32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ReplacementString

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceGroupName

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

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SchemaName

Especifica o nome de um esquema.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServerName

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

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SuffixSize

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

Tipo:Nullable<T>[UInt32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-TableName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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