Set-AzSqlDatabaseDataMaskingRule

Establece las propiedades de una regla de enmascaramiento de datos para una base de datos.

Syntax

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

El cmdlet Set-AzSqlDatabaseDataMaskingRule establece una regla de enmascaramiento de datos para una base de datos de Azure SQL. Para usar el cmdlet , proporcione los parámetros ResourceGroupName, ServerName, DatabaseName y RuleId para identificar la regla. Puede proporcionar cualquiera de los parámetros de SchemaName, TableNamey ColumnName para redestinar la regla. Especifique el parámetro MaskingFunction para modificar cómo se enmascaran los datos. Si MaskingFunction tiene un valor de número o texto, puede especificar los parámetros NumberFrom y NumberTo para el enmascaramiento de números, o PrefixSize, ReplacementString y SuffixSize para el enmascaramiento de textos. Si el comando se ejecuta correctamente y especifica el parámetro PassThru, el cmdlet devuelve un objeto que describe las propiedades de la regla de enmascaramiento de datos y los identificadores de reglas. Los identificadores de regla incluyen, entre otros, ResourceGroupName, ServerName, DatabaseName y RuleId. Este cmdlet también es compatible con el servicio SQL Server Stretch Database de Azure.

Ejemplos

Ejemplo 1: Cambiar el intervalo de una regla de enmascaramiento de datos en una base de datos

Set-AzSqlDatabaseDataMaskingRule -ResourceGroupName $params.rgname -ServerName $params.serverName  -DatabaseName $params.databaseName -SchemaName "dbo" -TableName  "table1" -ColumnName "column1" -MaskingFunction "Default"

Este comando modifica una regla de enmascaramiento de datos que tiene el identificador Rule17. Esa regla funciona en la base de datos denominada Database01 en el servidor Server01. Este comando cambia los límites del intervalo en el que se genera un número aleatorio como valor enmascarado. El nuevo intervalo está comprendido entre 23 y 42.

Ejemplo 2

Establece las propiedades de una regla de enmascaramiento de datos para una base de datos. (generado automáticamente)

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 el nombre de la columna de destino de la regla de enmascaramiento.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseName

Especifica el nombre de la base de datos.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaskingFunction

Especifica la función de enmascaramiento que usa la regla. Los valores permitidos para este parámetro son los siguientes:

  • Valor predeterminado
  • NoMasking
  • Texto
  • Número
  • SocialSecurityNumber
  • CreditCardNumber
  • Correo electrónico El valor predeterminado es Predeterminado.
Type:String
Accepted values:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NumberFrom

Especifica el número de límite inferior del intervalo desde el que se selecciona un valor aleatorio. Especifique este parámetro solo si especifica un valor de Number para el parámetro MaskingFunction . El valor predeterminado es 0.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NumberTo

Especifica el número de límite superior del intervalo desde el que se selecciona un valor aleatorio. Especifique este parámetro solo si especifica un valor de Number para el parámetro MaskingFunction . El valor predeterminado es 0.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ningún resultado.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrefixSize

Especifica el número de caracteres al principio del texto que no están enmascarados. Especifique este parámetro solo si especifica un valor de Text para el parámetro MaskingFunction . El valor predeterminado es 0.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ReplacementString

Especifica el número de caracteres al final del texto que no están enmascarados. Especifique este parámetro solo si especifica un valor de Text para el parámetro MaskingFunction . El valor predeterminado es 0.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Especifica el nombre del grupo de recursos al que se asigna la base de datos.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SchemaName

Especifica el nombre de un esquema.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServerName

Especifica el nombre del servidor que hospeda la base de datos.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SuffixSize

Especifica el número de caracteres al final del texto que no están enmascarados. Especifique este parámetro solo si especifica un valor de Text para el parámetro MaskingFunction . El valor predeterminado es 0.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TableName

Especifica el nombre de la tabla de base de datos que contiene la columna enmascarada.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Salidas

DatabaseDataMaskingRuleModel