你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Set-AzSqlDatabaseDataMaskingRule

设置数据库的数据掩码规则的属性。

语法

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

说明

Set-AzSqlDatabaseDataMaskingRule cmdlet 为 Azure SQL 数据库设置数据掩码规则。 若要使用 cmdlet,请提供 ResourceGroupNameServerNameDatabaseName,以及 RuleId 参数来标识规则。 可以提供 SchemaNameTableNameColumnName 的任何参数来重定规则。 指定 MaskingFunction 参数以修改数据屏蔽方式。 如果为 MaskingFunction指定数字或文本值,则可以指定数字掩码 NumberFromNumberTo 参数,或 PrefixSizeReplacementString,以及 SuffixSize 参数进行文本掩码。 如果命令成功,并且指定了 PassThru 参数,则 cmdlet 将返回一个对象,该对象描述数据掩码规则属性和规则标识符。 规则标识符包括但不限于 ResourceGroupName、ServerNameDatabaseNameRuleId。 Azure 上的 SQL Server Stretch Database 服务也支持此 cmdlet。

示例

示例 1:更改数据库中数据掩码规则的范围

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

此命令修改 ID Rule17 的数据掩码规则。 该规则在服务器 Server01 上名为 Database01 的数据库中运行。 此命令将更改随机数作为掩码值生成的间隔的边界。 新范围介于 23 和 42 之间。

示例 2

设置数据库的数据掩码规则的属性。 (自动生成)

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'

参数

-ColumnName

指定掩码规则针对的列的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Confirm

在运行 cmdlet 之前,提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-DatabaseName

指定数据库的名称。

类型:String
Position:2
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MaskingFunction

指定规则使用的掩码函数。 此参数的可接受值为:

  • 违约
  • NoMasking
  • 发短信
  • SocialSecurityNumber
  • CreditCardNumber
  • 电子邮件 默认值为默认值。
类型:String
接受的值:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-NumberFrom

指定从中选择随机值的间隔的下限数。 仅当为 MaskingFunction 参数指定 Number 值时,才指定此参数。 默认值为 0。

类型:Nullable<T>[Double]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-NumberTo

指定从中选择随机值的间隔的上限。 仅当为 MaskingFunction 参数指定 Number 值时,才指定此参数。 默认值为 0。

类型:Nullable<T>[Double]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-PassThru

返回一个对象,该对象表示正在使用的项。 默认情况下,此 cmdlet 不生成任何输出。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PrefixSize

指定未屏蔽的文本开头的字符数。 仅当为 MaskingFunction 参数指定 Text 值时,才指定此参数。 默认值为 0。

类型:Nullable<T>[UInt32]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ReplacementString

指定未屏蔽的文本末尾的字符数。 仅当为 MaskingFunction 参数指定 Text 值时,才指定此参数。 默认值为 0。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ResourceGroupName

指定为其分配数据库的资源组的名称。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-SchemaName

指定架构的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ServerName

指定承载数据库的服务器的名称。

类型:String
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-SuffixSize

指定未屏蔽的文本末尾的字符数。 仅当为 MaskingFunction 参数指定 Text 值时,才指定此参数。 默认值为 0。

类型:Nullable<T>[UInt32]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-TableName

指定包含屏蔽列的数据库表的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

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

输出

DatabaseDataMaskingRuleModel