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、DatabaseNameRuleId の各パラメーターを指定してルールを識別します。 SchemaNameTableName、および ColumnName の任意のパラメーターを指定して、ルールのターゲットを再指定することができます。 データのマスク方法を変更するには、MaskingFunction パラメーターを指定します。 MaskingFunction に数値またはテキストの値を指定した場合は、数値マスキングについては NumberFrom および NumberTo パラメーターを指定し、テキスト マスキングについては PrefixSizeReplacementString、および SuffixSize パラメーターを指定することができます。 コマンドが成功し、 PassThru パラメーターが指定されている場合、コマンドレットはデータ マスキング ルールのプロパティを記述するオブジェクトとルール識別子を返します。 ルール識別子には、ResourceGroupName、ServerNameDatabaseNameRuleId が含まれますが、これらに限定されません。 このコマンドレットは、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

マスク 規則の対象となる列の名前を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseName

データベースの名前を指定します。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaskingFunction

ルールが使用するマスク関数を指定します。 このパラメーターの有効値は、次のとおりです。

  • 既定値
  • NoMasking
  • Text
  • 番号
  • SocialSecurityNumber
  • CreditCardNumber
  • 電子メール 既定値は既定値です。
Type:String
Accepted values:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NumberFrom

ランダムな値を選択する間隔の下限番号を指定します。 このパラメーターは、MaskingFunction パラメーターに Number の値を指定した場合にのみ指定します。 既定値は0です。

Type:Nullable<T>[Double]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NumberTo

ランダムな値が選択される間隔の上限番号を指定します。 このパラメーターは、MaskingFunction パラメーターに Number の値を指定した場合にのみ指定します。 既定値は0です。

Type:Nullable<T>[Double]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

作業中の項目を表すオブジェクトを返します。 既定では、このコマンドレットによる出力はありません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrefixSize

マスクされないテキストの先頭の文字数を指定します。 このパラメーターは、MaskingFunction パラメーターに Text の値を指定する場合にのみ指定します。 既定値は0です。

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ReplacementString

マスクされないテキストの末尾の文字数を指定します。 このパラメーターは、MaskingFunction パラメーターに Text の値を指定する場合にのみ指定します。 既定値は0です。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

データベースが割り当てられるリソース グループの名前を指定します。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SchemaName

スキーマの名前を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServerName

データベースをホストするサーバーの名前を指定します。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SuffixSize

マスクされないテキストの末尾の文字数を指定します。 このパラメーターは、MaskingFunction パラメーターに Text の値を指定する場合にのみ指定します。 既定値は0です。

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TableName

マスクされた列を含むデータベース テーブルの名前を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String

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]]

出力

DatabaseDataMaskingRuleModel