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