Set-AzureRmSqlDatabaseDataMaskingRule
Imposta le proprietà di 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
Set-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 Set-AzureRmSqlDatabaseDataMaskingRule 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
PS C:\>Set-AzureRmSqlDatabaseDataMaskingRule -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.
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: | False |
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 non mascherato. Specificare questo parametro solo se si specifica il valore Text per il parametro MaskingFunction . Il valore predefinito è 0.
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
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]]