New-AzSqlDatabaseDataMaskingRule
データベースのデータ マスク ルールを作成します。
構文
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>]
説明
New-AzSqlDatabaseDataMaskingRule コマンドレットは、Azure SQL データベースのデータ マスク 規則を作成します。 コマンドレットを使用するには、 ResourceGroupName、 ServerName、および DatabaseName パラメーターを使用してルールを識別します。 TableName および ColumnName を指定して、ルールのターゲットを指定し、MaskingFunction パラメーターを指定して、データのマスク方法を定義します。 MaskingFunction の値が数値またはテキストである場合は、数値マスキングについては NumberFrom および NumberTo パラメーターを指定し、テキスト マスキングについては PrefixSize、ReplacementString、および SuffixSize を指定することができます。 コマンドが成功し、 PassThru パラメーターが使用されている場合、コマンドレットはルール識別子に加えてデータ マスキング ルールのプロパティを記述するオブジェクトを返します。 ルール識別子には、 ResourceGroupName、 ServerName、 DatabaseName、および RuleID が含まれますが、これらに限定されません。 このコマンドレットは、Azure 上の SQL Server Stretch Database サービスでもサポートされています。
例
例 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 |
配置: | 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 |
必須: | True |
パイプライン入力を受け取る: | 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 の値を指定する場合にのみ指定します。 既定値は空の文字列です。
型: | 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]]