Set-AzSqlDatabaseDataMaskingRule

設定資料庫的數據遮罩規則屬性。

Syntax

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

Set-AzSqlDatabaseDataMaskingRule Cmdlet 會設定 Azure SQL 資料庫的數據遮罩規則。 若要使用 Cmdlet,請提供 ResourceGroupName、ServerNameDatabaseNameRuleId 參數來識別規則。 您可以提供 SchemaNameTableNameColumnName 的任何參數,以重設規則的目標。 指定 MaskingFunction 參數,以修改資料的遮蔽方式。 如果您為 MaskingFunction 指定的值為 [數字] 或 [文字],則可針對數字遮罩指定 NumberFromNumberTo 參數,或針對文字遮罩指定 PrefixSizeReplacementStringSuffixSize 參數。 如果命令成功,而且您指定 PassThru 參數,此 Cmdlet 傳回的物件會描述資料遮罩規則屬性和規則識別碼。 規則識別碼包括但不限於 ResourceGroupName、ServerName、DatabaseNameRuleId 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"

此命令會修改標識碼為 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

指定遮罩規則的目標數據行名稱。

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

-Confirm

執行 Cmdlet 之前先提示您確認。

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

-DatabaseName

指定資料庫的名稱。

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

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaskingFunction

指定規則使用的遮罩函式。 此參數可接受的值為:

  • 預設
  • NoMasking
  • Text
  • 數字
  • SocialSecurityNumber
  • CreditCardNumber
  • 電子郵件 預設值為 Default。
Type:String
Accepted values:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NumberFrom

指定選取隨機值之間隔的下限數目。 只有在您指定 MaskingFunction 參數的 Number 值時,才指定此參數。 預設值是 0。

Type:Nullable<T>[Double]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NumberTo

指定選取隨機值之間隔的上限。 只有在您指定 MaskingFunction 參數的 Number 值時,才指定此參數。 預設值是 0。

Type:Nullable<T>[Double]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

會傳回 物件,代表您正在使用的專案。 根據預設,此 Cmdlet 不會產生任何輸出。

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

-PrefixSize

指定未遮罩之文字開頭的字元數。 只有在您為 MaskingFunction 參數指定 Text 的值時,才指定此參數。 預設值是 0。

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ReplacementString

指定未遮罩之文字結尾的字元數。 只有在您為 MaskingFunction 參數指定 Text 的值時,才指定此參數。 預設值是 0。

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

-ResourceGroupName

指定指派資料庫的資源群組名稱。

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

-SchemaName

指定架構的名稱。

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

-ServerName

指定裝載資料庫之伺服器的名稱。

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

-SuffixSize

指定未遮罩之文字結尾的字元數。 只有在您為 MaskingFunction 參數指定 Text 的值時,才指定此參數。 預設值是 0。

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TableName

指定包含遮罩資料列的資料庫數據表名稱。

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

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