New-AzSqlDatabaseDataMaskingRule

  • Referencia
Módulo:
Az.Sql

Crea una regla de enmascaramiento de datos para una base de datos.

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

El cmdlet New-AzSqlDatabaseDataMaskingRule crea una regla de enmascaramiento de datos para una base de datos de Azure SQL. Para usar el cmdlet , use los parámetros ResourceGroupName, ServerName y DatabaseName para identificar la regla. Proporcione tableName y ColumnName para especificar el destino de la regla y el parámetro MaskingFunction para definir 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 se usa el parámetro PassThru, el cmdlet devuelve un objeto que describe las propiedades de la regla de enmascaramiento de datos, además de 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: Crear una regla de enmascaramiento de datos para una columna de número en una base de datos

New-AzSqlDatabaseDataMaskingRule -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"  -SchemaName "Schema01" -TableName "Table01" -ColumnName "Column01" -MaskingFunction "Number" -NumberFrom 5 -NumberTo 14

Este comando crea una regla de enmascaramiento de datos para la columna denominada Column01 en la tabla denominada Table01 en el esquema denominado Schema01. La base de datos denominada Database01 contiene todos estos elementos. La regla es una regla de enmascaramiento numérico que usa un número aleatorio entre 5 y 14 como valor de máscara.

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:True
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 una cadena vacía.

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