Compartir a través de

New-AzSqlDatabaseDataMaskingRule

  • Referencia
Módulo:
Az.Sql

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

Sintaxis

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 , ServerNamey DatabaseName para identificar la regla. Proporcione el TableName y ColumnName para especificar el destino de la regla y el parámetro MaskingFun ction para definir cómo se enmascaran los datos. Si maskingFunction tiene un valor de Number o Text, puede especificar los parámetros NumberFrom y NumberTo, para enmascaramiento de números o el PrefixSize, ReplacementStringy SuffixSize para enmascaramiento de texto. 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 regla. Los identificadores de regla incluyen, entre otros, ResourceGroupName, ServerName, DatabaseNamey RuleID. Este cmdlet también es compatible con el servicio SQL Server Stretch Database en 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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatabaseName

Especifica el nombre de la base de datos.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MaskingFunction

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

  • Predeterminado
  • NoMasking
  • Mensaje de texto
  • Número
  • SocialSecurityNumber
  • CreditCardNumber
  • Correo electrónico El valor predeterminado es Predeterminado.
Tipo:String
Valores aceptados:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:Nullable<T>[Double]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:Nullable<T>[Double]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ninguna salida.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Nullable<T>[UInt32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ResourceGroupName

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

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SchemaName

Especifica el nombre de un esquema.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ServerName

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

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:Nullable<T>[UInt32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-TableName

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

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