New-AzSqlDatabaseDataMaskingRule

  • Référence
Module:
Az.Sql

Crée une règle de masquage des données pour une base de données.

Syntaxe

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

L’applet de commande New-AzSqlDatabaseDataMaskingRule crée une règle de masquage des données pour une base de données Azure SQL. Pour utiliser l’applet de commande, utilisez les paramètres ResourceGroupName, ServerName et DatabaseName pour identifier la règle. Indiquez TableName et ColumnName pour spécifier la cible de la règle et le paramètre MaskingFunction pour définir la façon dont les données sont masquées. Si MaskingFunction a la valeur Number ou Text, vous pouvez spécifier les paramètres NumberFrom et NumberTo pour le masquage des nombres, ou PrefixSize, ReplacementStringet SuffixSize pour le masquage de texte. Si la commande s’exécute correctement et que le paramètre PassThru est utilisé, la cmdlet retourne un objet décrivant les propriétés de la règle de masquage des données en plus des 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 : Créer une règle de masquage des données pour une colonne numérique dans une base de données

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

Cette commande crée une règle de masquage des données pour la colonne nommée Column01 dans la table nommée Table01 dans le schéma nommé Schema01. La base de données nommée Database01 contient tous ces éléments. La règle est une règle de masquage de nombres qui utilise un nombre aléatoire compris entre 5 et 14 comme valeur de masque.

Paramètres

-ColumnName

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DatabaseName

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

Type:String
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

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

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
  • Nombre
  • SocialSecurityNumber
  • CreditCardNumber
  • E-mail La valeur par défaut est Default.
Type:String
Valeurs acceptées:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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 une chaîne vide.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceGroupName

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

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SchemaName

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ServerName

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

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-TableName

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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