Set-AzSqlDatabaseDataMaskingRule
データベースのデータ マスク ルールのプロパティを設定します。
構文
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>] 説明
Set-AzSqlDatabaseDataMaskingRule コマンドレットは、Azure SQL データベースのデータ マスク 規則を設定します。 コマンドレットを使用するには、ルールを識別するために、 ResourceGroupName、 ServerName、 DatabaseName、および RuleId パラメーターを指定します。 SchemaName、TableName、および ColumnName の任意のパラメーターを指定して、ルールのターゲットを再指定することができます。 データのマスク方法を変更するには、MaskingFunction パラメーターを指定します。 MaskingFunction に数値またはテキストの値を指定した場合は、数値マスキングについては NumberFrom および NumberTo パラメーターを指定し、テキスト マスキングについては PrefixSize、ReplacementString、および SuffixSize パラメーターを指定することができます。 コマンドが成功し、 PassThru パラメーターが指定されている場合、コマンドレットはデータ マスキング ルールのプロパティを記述するオブジェクトとルール識別子を返します。 ルール識別子には、 ResourceGroupName、 ServerName、 DatabaseName、および RuleId が含まれますが、これらに限定されません。 このコマンドレットは、Azure 上の SQL Server Stretch Database サービスでもサポートされています。
例
例 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
データベースのデータ マスク ルールのプロパティを設定します。 (自動生成)
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 |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DatabaseName
データベースの名前を指定します。
| 型: | String |
| 配置: | 2 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
| 型: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MaskingFunction
ルールが使用するマスク関数を指定します。 このパラメーターの有効値は、次のとおりです。
- 既定値
- NoMasking
- Text
- 番号
- SocialSecurityNumber
- CreditCardNumber
- 電子メール 既定値は既定値です。
| 型: | String |
| 指定可能な値: | NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-NumberFrom
ランダムな値を選択する間隔の下限番号を指定します。 このパラメーターは、 MaskingFunction パラメーターに Number の値を指定した場合にのみ指定します。 既定値は0です。
| 型: | Nullable<T>[Double] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-NumberTo
ランダムな値が選択される間隔の上限番号を指定します。 このパラメーターは、 MaskingFunction パラメーターに Number の値を指定した場合にのみ指定します。 既定値は0です。
| 型: | Nullable<T>[Double] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PassThru
作業中の項目を表すオブジェクトを返します。 既定では、このコマンドレットによる出力はありません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PrefixSize
マスクされないテキストの先頭の文字数を指定します。 このパラメーターは、 MaskingFunction パラメーターに Text の値を指定する場合にのみ指定します。 既定値は0です。
| 型: | Nullable<T>[UInt32] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ReplacementString
マスクされないテキストの末尾の文字数を指定します。 このパラメーターは、 MaskingFunction パラメーターに Text の値を指定する場合にのみ指定します。 既定値は0です。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ResourceGroupName
データベースが割り当てられるリソース グループの名前を指定します。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-SchemaName
スキーマの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ServerName
データベースをホストするサーバーの名前を指定します。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-SuffixSize
マスクされないテキストの末尾の文字数を指定します。 このパラメーターは、 MaskingFunction パラメーターに Text の値を指定する場合にのみ指定します。 既定値は0です。
| 型: | Nullable<T>[UInt32] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-TableName
マスクされた列を含むデータベース テーブルの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
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]]
出力
関連リンク
Azure PowerShell