Set-AzSqlDatabaseDataMaskingRule

  • Riferimento
Modulo:
Az.Sql

Imposta le proprietà di una regola di maschera dati per un database.

Sintassi

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

Descrizione

Il cmdlet Set-AzSqlDatabaseDataMaskingRule imposta una regola di maschera dati per un database SQL di Azure. Per usare il cmdlet, specificare i parametri ResourceGroupName, ServerName, DatabaseName e RuleId per identificare la regola. Per ridestinare la regola, è possibile specificare uno qualsiasi dei parametri SchemaName, TableName e ColumnName. Specificare il parametro MaskingFunction per modificare il modo in cui i dati vengono mascherati. Se per MaskingFunction viene specificato come valore un numero o testo, è possibile specificare i parametri NumberFrom e NumberTo per mascherare i numeri o i parametri PrefixSize, ReplacementString e SuffixSize per mascherare il testo. Se il comando ha esito positivo e viene specificato il parametro PassThru, il cmdlet restituisce un oggetto che descrive le proprietà della regola di maschera dati e gli identificatori della regola. Gli identificatori delle regole includono, ma non sono limitati a, ResourceGroupName, ServerName, DatabaseName e RuleId. Questo cmdlet è supportato anche dal servizio SQL Server Stretch Database in Azure.

Esempio

Esempio 1: Modificare l'intervallo di una regola di maschera dati in un database

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

Questo comando modifica una regola di maschera dati con ID Rule17. Tale regola opera nel database denominato Database01 nel server Server01. Questo comando modifica i limiti per l'intervallo in cui viene generato un numero casuale come valore mascherato. Il nuovo intervallo è compreso tra 23 e 42.

Esempio 2

Imposta le proprietà di una regola di maschera dati per un database. (generato automaticamente)

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'

Parametri

-ColumnName

Specifica il nome della colonna di destinazione della regola di mascheramento.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DatabaseName

Specifica il nome del database.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MaskingFunction

Specifica la funzione di maschera utilizzata dalla regola. I valori validi per questo parametro sono:

  • Predefiniti
  • NoMasking
  • Testo
  • Numero
  • SocialSecurityNumber
  • CreditCardNumber
  • Email Il valore predefinito è Default.
Tipo:String
Valori accettati:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NumberFrom

Specifica il numero di limiti inferiore dell'intervallo da cui è selezionato un valore casuale. Specificare questo parametro solo se si specifica il valore Number per il parametro MaskingFunction . Il valore predefinito è 0.

Tipo:Nullable<T>[Double]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NumberTo

Specifica il numero limite superiore dell'intervallo da cui è selezionato un valore casuale. Specificare questo parametro solo se si specifica il valore Number per il parametro MaskingFunction . Il valore predefinito è 0.

Tipo:Nullable<T>[Double]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Restituisce un oggetto che rappresenta l'elemento in uso. Per impostazione predefinita, il cmdlet non genera alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PrefixSize

Specifica il numero di caratteri all'inizio del testo non mascherato. Specificare questo parametro solo se si specifica il valore Text per il parametro MaskingFunction . Il valore predefinito è 0.

Tipo:Nullable<T>[UInt32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ReplacementString

Specifica il numero di caratteri alla fine del testo non mascherato. Specificare questo parametro solo se si specifica il valore Text per il parametro MaskingFunction . Il valore predefinito è 0.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceGroupName

Specifica il nome del gruppo di risorse a cui è assegnato il database.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SchemaName

Specifica il nome di uno schema.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServerName

Specifica il nome del server che ospita il database.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SuffixSize

Specifica il numero di caratteri alla fine del testo non mascherato. Specificare questo parametro solo se si specifica il valore Text per il parametro MaskingFunction . Il valore predefinito è 0.

Tipo:Nullable<T>[UInt32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-TableName

Specifica il nome della tabella di database che contiene la colonna mascherata.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

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

Output

DatabaseDataMaskingRuleModel