Set-AzSqlDatabaseDataMaskingRule

Módulo:

Az.Sql Module

Define as propriedades de uma regra de mascaramento de dados para um banco de dados.

Sintaxe

Default (Default)

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 número ou texto para MaskingFunction, poderá especificar os parâmetros NumberFrom e NumberTo para o mascaramento de números ou os parâmetros PrefixSize, ReplacementString e SuffixSize para mascaramento de texto. Se o comando for bem-sucedido e você especificar o parâmetro PassThru, o cmdlet retornará um objeto que descreve as propriedades da regra de mascaramento de dados e os 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: 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"

Esse comando modifica uma regra de mascaramento de dados que tem a Regra de ID17. Essa regra opera no banco de dados chamado Database01 no servidor Server01. Esse comando altera os limites do intervalo no qual um número aleatório é gerado como o valor mascarado. O novo intervalo está entre 23 e 42.

Exemplo 2

Define as propriedades de uma regra de mascaramento de dados para um banco de dados. (autogenerated)

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.

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:	False
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 é 0.

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

Links Relacionados

• Get-AzSqlDatabaseDataMaskingRule
• New-AzSqlDatabaseDataMaskingRule
• Remove-AzSqlDatabaseDataMaskingRule
• Documentação do Banco de Dados SQL