Dela via


Set-AzSqlDatabaseDataMaskingRule

Anger egenskaperna för en datamaskeringsregel för en databas.

Syntax

Default (Standard)

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

Cmdleten Set-AzSqlDatabaseDataMaskingRule anger en datamaskeringsregel för en Azure SQL-databas. Om du vill använda cmdleten anger du parametrarna ResourceGroupName, ServerName, DatabaseName och RuleId för att identifiera regeln. Du kan ange någon av parametrarna SchemaName, TableName eller ColumnName för att rikta om regeln. Ange parametern MaskingFunction för att ändra hur data maskeras. Om du anger värdet Tal eller Text för MaskingFunction kan du ange parametrarna NumberFrom och NumberTo för talmaskering eller parametrarna PrefixSize, ReplacementString och SuffixSize för textmaskering. Om kommandot lyckas, och om du anger parametern PassThru , returnerar cmdleten ett objekt som beskriver egenskaperna för datamaskeringsregeln och regelidentifierarna. Regelidentifierare inkluderar, men är inte begränsade till, ResourceGroupName, ServerName, DatabaseName och RuleId. Den här cmdleten stöds också av SQL Server Stretch Database-tjänsten i Azure.

Exempel

Exempel 1: Ändra intervallet för en datamaskeringsregel i en databas

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

Det här kommandot ändrar en datamaskeringsregel som har ID-regeln 17. Den regeln fungerar i databasen med namnet Database01 på server Server01. Det här kommandot ändrar gränserna för det intervall där ett slumpmässigt tal genereras som det maskerade värdet. Det nya intervallet är mellan 23 och 42.

Exempel 2

Anger egenskaperna för en datamaskeringsregel för en databas. (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'

Parametrar

-ColumnName

Anger namnet på kolumnen som maskeringsregeln ska rikta in sig på.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DatabaseName

Anger namnet på databasen.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:2
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-MaskingFunction

Anger den maskeringsfunktion som regeln använder. De godtagbara värdena för den här parametern är:

  • Förinställning
  • NoMasking
  • Text
  • Nummer
  • SocialSecurityNumber
  • CreditCard-nummer
  • E-post Standardvärdet är Standard.

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-NumberFrom

Anger det lägre gränsvärdet för det intervall som ett slumpmässigt värde väljs från. Ange endast den här parametern om du anger värdet Number för parametern MaskingFunction . Standardvärdet är 0.

Parameteregenskaper

Typ:

Nullable<T>[Double]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-NumberTo

Anger det övre gränsvärdet för det intervall som ett slumpmässigt värde väljs från. Ange endast den här parametern om du anger värdet Number för parametern MaskingFunction . Standardvärdet är 0.

Parameteregenskaper

Typ:

Nullable<T>[Double]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten inga utdata.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PrefixSize

Anger antalet tecken i början av texten som inte är maskerade. Ange endast den här parametern om du anger värdet Text för parametern MaskingFunction . Standardvärdet är 0.

Parameteregenskaper

Typ:

Nullable<T>[UInt32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ReplacementString

Anger antalet tecken i slutet av texten som inte är maskerade. Ange endast den här parametern om du anger värdet Text för parametern MaskingFunction . Standardvärdet är 0.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ResourceGroupName

Anger namnet på den resursgrupp som databasen har tilldelats.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-SchemaName

Anger namnet på ett schema.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ServerName

Anger namnet på den server som är värd för databasen.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-SuffixSize

Anger antalet tecken i slutet av texten som inte är maskerade. Ange endast den här parametern om du anger värdet Text för parametern MaskingFunction . Standardvärdet är 0.

Parameteregenskaper

Typ:

Nullable<T>[UInt32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-TableName

Anger namnet på databastabellen som innehåller den maskerade kolumnen.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

Nullable<T>

Nullable<T>

Utdata

DatabaseDataMaskingRuleModel