Set-AzureRmSqlDatabaseDataMaskingRule
設定資料庫的數據遮罩規則屬性。
警告
自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源 。
語法
Set-AzureRmSqlDatabaseDataMaskingRule
[-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-AzureRmSqlDatabaseDataMaskingRule 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:變更資料庫中數據遮罩規則的範圍
PS C:\>Set-AzureRmSqlDatabaseDataMaskingRule -ResourceGroupName $params.rgname -ServerName $params.serverName -DatabaseName $params.databaseName -SchemaName "dbo" -TableName "table1" -ColumnName "column1" -MaskingFunction "Default"
此命令會修改標識碼為 Rule17 的數據遮罩規則。 該規則會在伺服器 Server01 上名為 Database01 的資料庫運作。 此命令會變更隨機數產生為遮罩值的間隔界限。 新範圍介於 23 到 42 之間。
參數
-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 |
別名: | AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-MaskingFunction
指定規則使用的遮罩函式。 此參數可接受的值為:
- 預設
- NoMasking
- Text
- 數字
- SocialSecurityNumber
- CreditCardNumber
- 電子郵件 預設值為 Default。
類型: | 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 |
輸入
Nullable<T>[[System.UInt32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Nullable<T>[[System.Double, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]