Set-AzSqlDatabaseDataMaskingRule

  • Référence
Module:
Az.Sql

Définit les propriétés d’une règle de masquage de données pour une base de données.

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

L’applet de commande Set-AzSqlDatabaseDataMaskingRule définit une règle de masquage des données pour une base de données Azure SQL. Pour utiliser l’applet de commande, fournissez les paramètres ResourceGroupName, ServerName, DatabaseName et RuleId pour identifier la règle. Vous pouvez fournir n’importe quel paramètre de SchemaName, TableName et ColumnName pour recibler la règle. Spécifiez le paramètre MaskingFunction pour modifier la façon dont les données sont masquées. Si vous spécifiez une valeur Number ou Text pour MaskingFunction, vous pouvez spécifier les paramètres NumberFrom et NumberTo pour le masquage des nombres ou les paramètres PrefixSize, ReplacementString et SuffixSize pour le masquage de texte. Si la commande s’exécute correctement et que vous spécifiez le paramètre PassThru, la cmdlet retourne un objet décrivant les propriétés de la règle de masquage des données et les identificateurs de la règle. Les identificateurs de règle incluent, mais ne sont pas limités à, ResourceGroupName, ServerName, DatabaseName et RuleId. Cette cmdlet est également prise en charge par le service SQL Server Stretch Database sur Azure.

Exemples

Exemple 1 : Modifier la plage d’une règle de masquage de données dans une base de données

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

Cette commande modifie une règle de masquage des données qui a la règle d’ID17. Cette règle fonctionne dans la base de données nommée Database01 sur le serveur Server01. Cette commande modifie les limites de l’intervalle dans lequel un nombre aléatoire est généré en tant que valeur masquée. La nouvelle plage est comprise entre 23 et 42.

Exemple 2

Définit les propriétés d’une règle de masquage de données pour une base de données. (généré automatiquement)

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'

Paramètres

-ColumnName

Spécifie le nom de la colonne ciblée par la règle de masquage.

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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-DatabaseName

Spécifie le nom de la base de données.

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

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

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

-MaskingFunction

Spécifie la fonction de masquage utilisée par la règle. Les valeurs valides pour ce paramètre sont :

  • Par défaut
  • NoMasking
  • Texte
  • Number
  • SocialSecurityNumber
  • CreditCardNumber
  • E-mail La valeur par défaut est Default.
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

Spécifie le nombre limité inférieur de l’intervalle à partir duquel une valeur aléatoire est sélectionnée. Spécifiez ce paramètre uniquement si vous spécifiez la valeur Number pour le paramètre MaskingFunction . La valeur par défaut est 0.

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

-NumberTo

Spécifie le numéro de limite supérieur de l’intervalle à partir duquel une valeur aléatoire est sélectionnée. Spécifiez ce paramètre uniquement si vous spécifiez la valeur Number pour le paramètre MaskingFunction . La valeur par défaut est 0.

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

-PassThru

Retourne un objet représentant l’élément que vous utilisez. Par défaut, cette applet de commande ne génère aucun résultat.

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

-PrefixSize

Spécifie le nombre de caractères au début du texte qui ne sont pas masqués. Spécifiez ce paramètre uniquement si vous spécifiez une valeur de Texte pour le paramètre MaskingFunction . La valeur par défaut est 0.

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

-ReplacementString

Spécifie le nombre de caractères à la fin du texte qui ne sont pas masqués. Spécifiez ce paramètre uniquement si vous spécifiez une valeur de Texte pour le paramètre MaskingFunction . La valeur par défaut est 0.

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

-ResourceGroupName

Spécifie le nom du groupe de ressources auquel la base de données est affectée.

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

-SchemaName

Spécifie le nom d’un schéma.

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

-ServerName

Spécifie le nom du serveur qui héberge la base de données.

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

-SuffixSize

Spécifie le nombre de caractères à la fin du texte qui ne sont pas masqués. Spécifiez ce paramètre uniquement si vous spécifiez une valeur de Texte pour le paramètre MaskingFunction . La valeur par défaut est 0.

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

-TableName

Spécifie le nom de la table de base de données qui contient la colonne masquée.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

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

Sorties

DatabaseDataMaskingRuleModel