New-AzureRmSqlDatabaseDataMaskingRule

Crea una regola di maschera dati per un database.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

New-AzureRmSqlDatabaseDataMaskingRule
   -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-AzureRmSqlDatabaseDataMaskingRule crea una regola di maschera dati per un database SQL di Azure. Per usare il cmdlet, usare i parametri ResourceGroupName, ServerName, DatabaseName e RuleId 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

PS C:\>New-AzureRmSqlDatabaseDataMaskingRule -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -RuleId "Rule01" -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. La regola è denominata Rule01.

Parametri

-ColumnName

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

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DatabaseName

Specifica il nome del database.

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

-DefaultProfile

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

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

-MaskingFunction

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

  • Default
  • NoMasking
  • Testo
  • Numero
  • SocialSecurityNumber
  • CreditCardNumber
  • Email Il valore predefinito è Default.
Type:String
Accepted values:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-ResourceGroupName

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

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

-SchemaName

Specifica il nome di uno schema.

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

-ServerName

Specifica il nome del server che ospita il database.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-TableName

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

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

-WhatIf

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

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

Input

String

Nullable<T>[[System.UInt32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Nullable<T>[[System.Double, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Output

DatabaseDataMaskingRuleModel