Set-SqlSensitivityClassification

  • リファレンス
モジュール:
SQLServer

データベース内の列の情報の種類や秘密度ラベル、情報の種類を設定します。

構文

Set-SqlSensitivityClassification
   -ColumnName <String[]>
   [-SuppressProviderContextWarning]
   [-SensitivityRank <SensitivityRank>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -ConnectionString <String>
   [-SensitivityRank <SensitivityRank>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -ServerInstance <PSObject>
   -DatabaseName <String>
   [-Credential <PSCredential>]
   [-SensitivityRank <SensitivityRank>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -Path <String>
   [-SensitivityRank <SensitivityRank>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -InputObject <Database>
   [-SensitivityRank <SensitivityRank>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]

説明

Set-SqlSensitivityClassification コマンドレットは、データベース内の列の情報の種類や秘密度ラベルを設定します。

列の情報の種類と秘密度ラベルと情報の種類も、SQL Server Management Studio (SSMS) リリース 17.5 以降を使用して設定します。

列の情報の種類と秘密度ラベルと情報の種類は、SQL Server Management Studio (SSMS) リリース 17.5 以降、拡張プロパティ カタログ ビュー、または Get-SqlSensitivityClassification コマンドレットを使用して表示できます。

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

例

例 1: Windows 認証を使用して 1 つの列に情報の種類と秘密度ラベルを設定する

PS C:\> Set-SqlSensitivityClassification -ServerInstance "MyComputer\MainInstance" -Database "myDatabase" -ColumnName "Sales.Customers.first_name" -InformationType "Name" -SensitivityLabel "Confidential - GDPR" -SensitivityRank "Low"

Column                      InformationType SensitivityLabel    SensitivityRank
------                      --------------- ----------------    ---------------
Sales.Customers.first_name  Name            Confidential - GDPR Low

列Sales.Customers.first_nameの情報の種類と秘密度ラベルをそれぞれNameConfidential - GDPR設定します。 情報の種類と秘密度ラベルの値は、以下に示す既定値に制限され、Tab キーを使用して取得できます。

例 2: Windows 認証を使用して単一列の情報の種類を設定する

PS C:\> Set-SqlSensitivityClassification -ServerInstance "MyComputer\MainInstance" -Database "myDatabase" -ColumnName "Sales.Customers.first_name" -InformationType "Personal"

Column                      InformationType SensitivityLabel SensitivityRank
------                      --------------- ---------------- ---------------
Sales.Customers.first_name  Personal

列 Sales.Customers.first_name の情報の種類を 〘 に設定します Personal。 秘密度ラベルは、以前に設定されている場合は設定解除されます。

例 3: 接続パラメーターを使用して 1 つの列の秘密度ラベルを設定する

PS C:\> Set-SqlSensitivityClassification -ServerInstance "MyComputer\MainInstance" -Database "myDatabase" -Credential (Get-Credential "sa") -ColumnName "Sales.Customers.ip_address" -SensitivityLabel "Confidential"

Column                      InformationType SensitivityLabel SensitivityRank
------                      --------------- ---------------- ---------------
Sales.Customers.ip_address                  Confidential

SQL Server ログインを使用するようにConfidential列Sales.Customers.ip_addressの秘密度ラベルを設定します。 この列の情報の種類は未設定のままです。 このコマンドを実行すると、認証を完了するためのパスワードの入力を求められます。

例 4: 現在のパス コンテキストを使用して、複数の列の情報の種類と分類ラベルを設定する

PS C:\> $columns = @("Sales.Customers.first_name" , "Sales.Customers.last_name")
PS C:\> Set-Location "SQLSERVER:\SQL\MyComputer\MainInstance\Databases\MyDatabase"
PS SQLSERVER:\SQL\MyComputer\MainInstance> Set-SqlSensitivityClassification -ColumnName $columns -InformationType "Name" -SensitivityLabel "Confidential - GDPR" -SensitivityRank "Critical"
 WARNING: Using provider context. Server = MyComputer, Database = MyDatabase.

Column                      InformationType SensitivityLabel    SensitivityRank
------                      --------------- ----------------    ---------------
Sales.Customers.first_name  Name            Confidential - GDPR Critical
Sales.Customers.last_name   Name            Confidential - GDPR Critical

列 Sales.Customers.first_name の情報の種類と秘密度ラベルを設定し、 Sales.Customers.last_name コマンドレットの引数として列名の配列を指定します。 すべての列は、同じ情報の種類と秘密度ラベルを受け取ります。 データベース接続情報は、作成 Set-Locationされたコンテキストから取得されます。

パラメーター

-ColumnName

情報の種類と秘密度ラベルが設定されている列の名前。

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

-ConnectionString

データベースに接続する接続文字列を指定します。 このパラメーターが存在する場合、他の接続パラメーターは無視されます

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

-Credential

データベースへの接続に使用する資格情報を指定します。

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

-DatabaseName

データベースの名前を指定します。 このコマンドレットは、ServerInstance パラメーターで指定されたインスタンス内のこのデータベースに接続します。

DatabaseName パラメーターが指定されていない場合、使用されるデータベースは、現在のパスで SQLSERVER:\SQL フォルダーとデータベース名の両方を指定するかどうかによって異なります。 パスで SQL フォルダーとデータベース名の両方が指定されている場合、このコマンドレットはパスで指定されたデータベースに接続します。

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

-InformationType

列に格納されている情報の種類を表す名前。 SensitivityLabel、InformationType、またはその両方の値を指定する必要があります。 指定できる値は制限されており、拡張できません。

Type:String
Accepted values:Networking, Contact Info, Credentials, Credit Card, Banking, Financial, Other, Name, National ID, SSN, Health, Date Of Birth
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

このコマンドレットで使用するデータベースを表すSQL Server管理オブジェクト (SMO) を指定します。

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

-Path

このコマンドレットが操作を実行するSQL Serverのインスタンスへのパスを指定します。 このパラメーターの値を指定しない場合、コマンドレットは現在の作業場所を使用します。

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

-SensitivityLabel

列に格納されているデータの秘密度を表す名前。 SensitivityLabel、InformationType、またはその両方の値を指定する必要があります。 指定できる値は制限されており、拡張できません。

Type:String
Accepted values:Public, General, Confidential, Confidential - GDPR, Highly Confidential, Highly Confidential - GDPR
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SensitivityRank

秘密度ランクを定義する定義済みの値セットに基づく識別子。 Advanced Threat Protection などの他のサービスで、ランクに基づいて異常を検出するために使用される場合があります

Type:SensitivityRank
Accepted values:None, Low, Medium, High, Critical
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServerInstance

データベース エンジンのインスタンスの名前を指定するサーバー インスタンスの名前 (文字列) または SQL Server管理オブジェクト (SMO) オブジェクトを指定します。 既定のインスタンスの場合は、コンピューター名 MyComputer のみを指定します。 名前付きインスタンスの場合は、ComputerName\InstanceName という形式を使用します。

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

-SuppressProviderContextWarning

このコマンドレットが、コマンドレットのデータベース コンテキストを確立するために現在の SQLSERVER:\SQL パス設定からデータベース コンテキストで使用されたことを示す警告を抑制することを示します。

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

入力

System.String[]

Microsoft.SqlServer.Management.Smo.Database

System.String

出力

System.Object