Delen via


New-AzSqlDatabaseDataMaskingRule

Hiermee maakt u een regel voor gegevensmaskering voor een database.

Syntaxis

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

Description

Met de cmdlet New-AzSqlDatabaseDataMaskingRule maakt u een gegevensmaskeringsregel voor een Azure SQL-database. Als u de cmdlet wilt gebruiken, gebruikt u de parameters ResourceGroupName, ServerName en DatabaseName om de regel te identificeren. Geef de TableName en ColumnName op om het doel van de regel en de parameter MaskingFunction op te geven om te definiëren hoe de gegevens worden gemaskeerd. Als MaskingFunction de waarde Getal of Tekst heeft, kunt u de parameters NumberFrom en NumberTo opgeven, voor nummermaskering of voor voorvoegsels, ReplacementString en SuffixSize voor tekstmaskering. Als de opdracht slaagt en de parameter PassThru wordt gebruikt, retourneert de cmdlet een object waarin de eigenschappen van de gegevensmaskeringsregel worden beschreven, naast de regel-id's. Regel-id's omvatten, maar zijn niet beperkt tot, ResourceGroupName, ServerName, DatabaseName en RuleID. Deze cmdlet wordt ook ondersteund door de SQL Server Stretch Database-service in Azure.

Voorbeelden

Voorbeeld 1: Een gegevensmaskeringsregel maken voor een numerieke kolom in een database

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

Met deze opdracht maakt u een gegevensmaskeringsregel voor de kolom Kolom01 in de tabel tabel met de naam Tabel01 in het schema met de naam Schema01. De database met de naam Database01 bevat al deze items. De regel is een regel voor nummermaskering die een willekeurig getal tussen 5 en 14 als maskerwaarde gebruikt.

Parameters

-ColumnName

Hiermee geeft u de naam van de kolom waarop de maskeringsregel is gericht.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DatabaseName

Hiermee geeft u de naam van de database.

Type:String
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaskingFunction

Hiermee geeft u de maskeringsfunctie op die door de regel wordt gebruikt. De aanvaardbare waarden voor deze parameter zijn:

  • Standaardinstelling
  • NoMasking
  • Sms verzenden
  • Aantal
  • SocialSecurityNumber
  • CreditCardNumber
  • E-mail De standaardwaarde is Standaard.
Type:String
Geaccepteerde waarden:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NumberFrom

Hiermee geeft u het ondergrensnummer van het interval waaruit een willekeurige waarde is geselecteerd. Geef deze parameter alleen op als u een waarde van Number opgeeft voor de parameter MaskingFunction . De standaardwaarde is 0.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NumberTo

Hiermee geeft u het bovengrensnummer van het interval waaruit een willekeurige waarde is geselecteerd. Geef deze parameter alleen op als u een waarde van Number opgeeft voor de parameter MaskingFunction . De standaardwaarde is 0.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

Retourneert een object dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PrefixSize

Hiermee geeft u het aantal tekens aan het begin van de tekst die niet worden gemaskeerd. Geef deze parameter alleen op als u een waarde van Text opgeeft voor de parameter MaskingFunction . De standaardwaarde is 0.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ReplacementString

Hiermee geeft u het aantal tekens aan het einde van de tekst die niet worden gemaskeerd. Geef deze parameter alleen op als u een waarde van Text opgeeft voor de parameter MaskingFunction . De standaardwaarde is een lege tekenreeks.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam op van de resourcegroep waaraan de database is toegewezen.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SchemaName

Hiermee geeft u de naam van een schema.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ServerName

Hiermee geeft u de naam op van de server die als host fungeert voor de database.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SuffixSize

Hiermee geeft u het aantal tekens aan het einde van de tekst die niet worden gemaskeerd. Geef deze parameter alleen op als u een waarde van Text opgeeft voor de parameter MaskingFunction . De standaardwaarde is 0.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TableName

Hiermee geeft u de naam van de databasetabel die de gemaskeerde kolom bevat.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

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

Uitvoerwaarden

DatabaseDataMaskingRuleModel