New-AzSqlDatabaseDataMaskingRule

模組:

Az.Sql Module

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

語法

Default (預設值)

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 的值為 [數字] 或 [文字]，則可針對數字遮罩指定 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
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	參閱

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DatabaseName

指定資料庫的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	2
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-DefaultProfile

用來與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶

參數屬性

類型:	IAzureContextContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzContext, AzureRmContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MaskingFunction

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

• 預設
• 無遮罩
• 文字
• Number
• 社會安全號碼
• CreditCardNumber
• 電子郵件預設值為預設值。

參數屬性

類型:	String
預設值:	None
接受的值:	NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-NumberFrom

指定從中選取隨機值的間隔的下限號碼。 只有在您為 MaskingFunction 參數指定 Number 值時，才指定此參數。 預設值為 0。

參數屬性

類型:	Nullable<T>[Double]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-NumberTo

指定從中選取隨機值的間隔上限號碼。 只有在您為 MaskingFunction 參數指定 Number 值時，才指定此參數。 預設值為 0。

參數屬性

類型:	Nullable<T>[Double]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-PassThru

返回一個物件，代表您正在處理的項目。 根據預設，此 Cmdlet 不會產生任何輸出。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PrefixSize

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

參數屬性

類型:	Nullable<T>[UInt32]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ReplacementString

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ResourceGroupName

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-SchemaName

指定結構描述的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ServerName

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	1
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-SuffixSize

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

參數屬性

類型:	Nullable<T>[UInt32]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-TableName

指定包含遮罩直欄的資料庫表格名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	威斯康星州

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

String

Nullable<T>

Nullable<T>

輸出

DatabaseDataMaskingRuleModel

相關連結

• Get-AzSqlDatabaseDataMaskingRule
• Remove-AzSqlDatabaseDataMaskingRule
• Set-AzSqlDatabaseDataMaskingRule
• SQL 資料庫檔