Delen via


Set-AzSqlDatabaseDataMaskingRule

Hiermee stelt u de eigenschappen van een gegevensmaskeringsregel voor een database in.

Syntaxis

Default (Standaard)

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

De cmdlet Set-AzSqlDatabaseDataMaskingRule stelt een gegevensmaskeringsregel in voor een Azure SQL-database. Als u de cmdlet wilt gebruiken, geeft u de parameters ResourceGroupName, ServerName, DatabaseName en RuleId op om de regel te identificeren. U kunt een van de parameters van SchemaName, TableName en ColumnName opgeven om de regel opnieuw te bepalen. Geef de parameter MaskingFunction op om te wijzigen hoe de gegevens worden gemaskeerd. Als u een waarde voor Getal of Tekst voor MaskingFunction opgeeft, kunt u de parameters NumberFrom en NumberTo opgeven voor nummermaskering of de parameters PrefixSize, ReplacementString en SuffixSize voor tekstmaskering. Als de opdracht slaagt en als u de Parameter PassThru opgeeft, retourneert de cmdlet een object dat de eigenschappen van de gegevensmaskeringregel en de regel-id's beschrijft. 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: Het bereik van een gegevensmaskeringsregel in een database wijzigen

Set-AzSqlDatabaseDataMaskingRule -ResourceGroupName $params.rgname -ServerName $params.serverName  -DatabaseName $params.databaseName -SchemaName "dbo" -TableName  "table1" -ColumnName "column1" -MaskingFunction "Default"

Met deze opdracht wijzigt u een gegevensmaskeringsregel met de id-regel17. Deze regel werkt in de database met de naam Database01 op server Server01. Met deze opdracht worden de grenzen gewijzigd voor het interval waarin een willekeurig getal wordt gegenereerd als de gemaskeerde waarde. Het nieuwe bereik ligt tussen 23 en 42.

Voorbeeld 2

Hiermee stelt u de eigenschappen van een gegevensmaskeringsregel voor een database in. (autogenerated)

Set-AzSqlDatabaseDataMaskingRule -ColumnName 'column1' -DatabaseName $params.databaseName -MaskingFunction NoMasking -NumberFrom 5 -NumberTo 14 -PrefixSize <UInt32> -ReplacementString <String> -ResourceGroupName $params.rgname -SchemaName 'dbo' -ServerName $params.serverName -SuffixSize <UInt32> -TableName 'table1'

Parameters

-ColumnName

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DatabaseName

Hiermee geeft u de naam van de database.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:2
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-MaskingFunction

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

  • Verstek
  • NoMasking
  • Tekst
  • Number
  • SocialSecurityNumber
  • Creditcardnummer
  • E-mail De standaardwaarde is Standaard.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Nullable<T>[Double]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Nullable<T>[Double]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-PassThru

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Nullable<T>[UInt32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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 0.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ResourceGroupName

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-SchemaName

Hiermee geeft u de naam van een schema.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ServerName

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Nullable<T>[UInt32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-TableName

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

Nullable<T>

Nullable<T>

Uitvoerwaarden

DatabaseDataMaskingRuleModel