Set-AzSqlDatabaseDataMaskingRule
語法
Default (預設值)
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、 ServerName、 DatabaseName 和 RuleId 參數來識別規則。
您可以提供 SchemaName、TableName 和 ColumnName 的任何參數,以重設規則的目標。
指定 MaskingFunction 參數,以修改資料的遮蔽方式。
如果您為 MaskingFunction 指定的值為 [數字] 或 [文字],則可針對數字遮罩指定 NumberFrom 和 NumberTo 參數,或針對文字遮罩指定 PrefixSize、ReplacementString 和 SuffixSize 參數。
如果命令成功,而且您指定 PassThru 參數,此 Cmdlet 傳回的物件會描述資料遮罩規則屬性和規則識別碼。
規則識別碼包括但不限於 ResourceGroupName、 ServerName、 DatabaseName 和 RuleId。
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
設定資料庫資料遮罩規則的屬性。 (autogenerated)
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
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DatabaseName
指定資料庫的名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 2 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-DefaultProfile
用來與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MaskingFunction
指定規則使用的遮罩函數。
此參數可接受的值為:
- 預設
- 無遮罩
- 文字
- Number
- 社會安全號碼
- CreditCardNumber
- 電子郵件預設值為預設值。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 接受的值: | NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-NumberFrom
指定從中選取隨機值的間隔的下限號碼。
只有在您為 MaskingFunction 參數指定 Number 值時,才指定此參數。
預設值為 0。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-NumberTo
指定從中選取隨機值的間隔上限號碼。
只有在您為 MaskingFunction 參數指定 Number 值時,才指定此參數。
預設值為 0。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-PassThru
返回一個物件,代表您正在處理的項目。
根據預設,此 Cmdlet 不會產生任何輸出。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PrefixSize
指定文字開頭未遮罩的字元數。
只有在您為 MaskingFunction 參數指定 Text 值時,才指定此參數。
預設值為 0。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ReplacementString
指定文字結尾未遮罩的字元數。
只有在您為 MaskingFunction 參數指定 Text 值時,才指定此參數。
預設值為 0。
參數屬性
| 類型: | 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。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-TableName
指定包含遮罩直欄的資料庫表格名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。
指令未執行。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸出