Dela via


New-AzSqlDatabaseDataMaskingRule

Skapar en datamaskeringsregel för en databas.

Syntax

Default (Standard)

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

Cmdleten New-AzSqlDatabaseDataMaskingRule skapar en datamaskeringsregel för en Azure SQL-databas. Om du vill använda cmdleten använder du parametrarna ResourceGroupName, ServerName och DatabaseName för att identifiera regeln. Ange TableName och ColumnName för att ange målet för regeln och parametern MaskingFunction för att definiera hur data maskeras. Om MaskingFunction har värdet Tal eller Text kan du ange parametrarna NumberFrom och NumberTo , för talmaskering eller PrefixSize, ReplacementString och SuffixSize för textmaskering. Om kommandot lyckas och parametern PassThru används returnerar cmdleten ett objekt som beskriver egenskaperna för datamaskeringsregeln utöver regelidentifierarna. Regelidentifierare omfattar, 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: Skapa en datamaskeringsregel för en talkolumn i en databas

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

Det här kommandot skapar en datamaskeringsregel för kolumnen Column01 i tabellen med namnet Table01 i schemat med namnet Schema01. Databasen med namnet Database01 innehåller alla dessa objekt. Regeln är en regel för talmaskering som använder ett slumpmässigt tal mellan 5 och 14 som maskvärde.

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:True
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 en tom sträng.

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