Partilhar via


New-AzureRmSqlDatabaseDataMaskingRule

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

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

New-AzureRmSqlDatabaseDataMaskingRule
   -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-AzureRmSqlDatabaseDataMaskingRule cria uma regra de mascaramento de dados para um banco de dados SQL do Azure. Para usar o cmdlet, use os parâmetros ResourceGroupName, ServerName, DatabaseName e RuleId para identificar a regra. Forneça 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 Number ou Text, você poderá especificar os parâmetros NumberFrom e NumberTo, para mascaramento de número, ou PrefixSize, ReplacementString e SuffixSize para mascaramento de texto. Se o comando for bem-sucedido e o parâmetro PassThru for usado, o cmdlet retornará um objeto descrevendo as propriedades da regra de mascaramento de dados, além dos 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: Criar uma regra de mascaramento de dados para uma coluna numérica em um banco de dados

PS C:\>New-AzureRmSqlDatabaseDataMaskingRule -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -RuleId "Rule01" -SchemaName "Schema01" -TableName "Table01" -ColumnName "Column01" -MaskingFunction "Number" -NumberFrom 5 -NumberTo 14

Este 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. A regra chama-se Rule01.

Parâmetros

-ColumnName

Especifica o nome da coluna direcionada pela regra de mascaramento.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DatabaseName

Especifica o nome do banco de dados.

Tipo:String
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.
Tipo:String
Valores aceites:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:Nullable<T>[Double]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:Nullable<T>[Double]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:Nullable<T>[UInt32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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 é uma cadeia de caracteres vazia.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceGroupName

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

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SchemaName

Especifica o nome de um esquema.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ServerName

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

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:Nullable<T>[UInt32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TableName

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Nullable<T>[[System.UInt32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Nullable<T>[[System.Double, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Saídas

DatabaseDataMaskingRuleModel