Compartilhar via

New-AzSqlDatabaseDataMaskingRule

Módulo:
Az.Sql Module

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

Sintaxe

Default (Default) 

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 o TableName e o ColumnName para especificar o destino da regra e o parâmetro MaskingFunction para definir como os dados são mascarados. Se a MaskingFunction tiver um valor de número ou texto, você poderá especificar os parâmetros NumberFrom e NumberTo para mascaramento de números 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 que descreve as propriedades da regra de mascaramento de dados, além dos 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: 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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DatabaseName

Especifica o nome do banco de dados.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MaskingFunction

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

  • Padrão
  • NoMasking
  • Texto
  • Número
  • SocialSecurityNumber
  • CreditCardNumber
  • Email O valor padrão é Padrão.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

Nullable<T>[Double]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

Nullable<T>[Double]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

Nullable<T>[UInt32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ResourceGroupName

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SchemaName

Especifica o nome de um esquema.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ServerName

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

Nullable<T>[UInt32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-TableName

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Nullable<T>

Nullable<T>

Saídas

DatabaseDataMaskingRuleModel