New-AzSqlDatabaseDataMaskingRule

Hiermee maakt u een regel voor gegevensmaskering voor een database.

Syntax

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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

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

-DatabaseName

Hiermee geeft u de naam van de database.

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
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

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
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

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

-SchemaName

Hiermee geeft u de naam van een schema.

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

-TableName

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

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

-WhatIf

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

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