New-AzSqlDatabaseDataMaskingRule

  • Referência
Módulo:
Az.Sql

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

Syntax

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, ServerName e DatabaseName 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

New-AzSqlDatabaseDataMaskingRule -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"  -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.

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:True
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 padrão é uma cadeia de caracteres vazia.

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