共用方式為

New-AzSqlDatabaseDataMaskingRule

  • 參考
模組:
Az.Sql

建立資料庫的數據遮罩規則。

語法

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

New-AzSqlDatabaseDataMaskingRule Cmdlet 會為 Azure SQL 資料庫建立數據遮罩規則。 若要使用 Cmdlet，請使用 ResourceGroupName、ServerName和 DatabaseName 參數來識別規則。 提供 TableName 和 ColumnName，以指定規則的目標和 MaskingFunction 參數，以定義數據遮罩的方式。 如果 MaskingFunction 的值為 Number 或 Text，您可以針對數位遮罩指定 NumberFrom 和 NumberTo 參数、PrefixSize、ReplacementString和 SuffixSize 文字遮罩。 如果命令成功且使用 PassThru 參數，則 Cmdlet 會傳回物件，除了規則標識碼之外，也會傳回描述數據遮罩規則屬性的物件。 規則識別碼 包括但不限於 ResourceGroupName、ServerName、DatabaseName和 RuleID。 Azure 上的 SQL Server Stretch Database 服務也支援此 Cmdlet。

範例

範例 1：為資料庫中的數字數據行建立數據遮罩規則

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

此命令會在名為 Schema01 的架構中，為名為 Table01 的數據表中名為 Column01 的數據行建立數據遮罩規則。 名為 Database01 的資料庫包含所有這些專案。 此規則是數位遮罩規則，使用介於 5 到 14 之間的隨機數位作為遮罩值。

參數

-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
  • 電子郵件 預設值為 Default。
類型:String
接受的值:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Position:Named
預設值:None
必要:True
接受管線輸入: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 值時，才指定此參數。 預設值為空字串。

類型: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