Condividi tramite

New-AzSqlDatabaseDataMaskingRule

  • Riferimento
Modulo:
Az.Sql

Crea una regola di maschera dati per un database.

Sintassi

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

Descrizione

Il cmdlet New-AzSqlDatabaseDataMaskingRule crea una regola di maschera dati per un database SQL di Azure. Per usare il cmdlet, usare i parametri ResourceGroupName, ServerName e DatabaseName per identificare la regola. Specificare TableName e ColumnName per specificare la destinazione della regola e il parametro MaskingFunction per definire la modalità di maschera dei dati. Se MaskingFunction ha 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 usato il parametro PassThru, oltre agli identificatori della regola il cmdlet restituisce un oggetto che descrive le proprietà della regola di maschera dati. 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: Creare una regola di maschera dati per una colonna numerica in un database

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

Questo comando crea una regola di maschera dati per la colonna denominata Column01 nella tabella denominata Table01 nello schema denominato Schema01. Il database denominato Database01 contiene tutti questi elementi. La regola è una regola di maschera numerica che usa un numero casuale compreso tra 5 e 14 come valore della maschera.

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:True
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 che non sono mascherati. Specificare questo parametro solo se si specifica il valore Text per il parametro MaskingFunction . Il valore predefinito è una stringa vuota.

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