Set-SqlSensitivityClassification

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

構文

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

説明

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

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

情報の種類と秘密度ラベルと列の情報の種類は、リリース 17.5 以降 SQL Server Management Studio (SSMS)拡張プロパティ カタログ ビュー、または 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 の情報の種類と秘密度ラベルをそれぞれ Name に設定し、Confidential - 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 ログインを使用して、列 Sales.Customers.ip_address の秘密度ラベルを Confidential に設定します。 この列の情報の種類は未設定のままです。 このコマンドを実行すると、認証を完了するためのパスワードの入力を求められます。

例 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_nameSales.Customers.last_name の情報の種類と秘密度ラベルを設定します。 すべての列は、同じ情報の種類と秘密度ラベルを受け取ります。 データベース接続情報は、Set-Locationによって作成されたコンテキストから取得されます。

パラメーター

-ColumnName

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

型:String[]
Aliases:Column
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ConnectionString

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Credential

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

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DatabaseName

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

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InformationType

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

型:String
指定可能な値:Networking, Contact Info, Credentials, Credit Card, Banking, Financial, Other, Name, National ID, SSN, Health, Date Of Birth
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-InputObject

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

型:Database
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Path

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ProgressAction

スクリプト、コマンドレット、またはプロバイダーによって生成された進行状況の更新 (Write-Progress コマンドレットによって生成された進行状況バーなど) に対する PowerShell の応答方法を決定します。 Write-Progress コマンドレットは、コマンドの状態を示す進行状況バーを作成します。

型:ActionPreference
Aliases:proga
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SensitivityLabel

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

型:String
指定可能な値:Public, General, Confidential, Confidential - GDPR, Highly Confidential, Highly Confidential - GDPR
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SensitivityRank

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

型:SensitivityRank
指定可能な値:None, Low, Medium, High, Critical
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ServerInstance

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

型:PSObject
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SuppressProviderContextWarning

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

System.String[]

Microsoft.SqlServer.Management.Smo.Database

System.String

出力

System.Object