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
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]]