次の方法で共有


Get-SqlSensitivityClassification

データベース内の列の秘密度ラベルと情報の種類を取得します。

構文

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

説明

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

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

秘密度ラベルと列の情報の種類は、リリース 17.5 以降 SQL Server Management Studio (SSMS) 使用するか、Set-SqlSensitivityClassification コマンドレットを使用して設定できます。

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

例 1: Windows 認証を使用してデータベースからすべての情報の種類と秘密度ラベルを取得する

PS C:\> Get-SqlSensitivityClassification -ServerInstance "MyComputer\MainInstance" -Database "myDatabase"

Column                      InformationType SensitivityLabel    SensitivityRank
------                      --------------- ----------------    ---------------
Sales.Customers.email       Contact Info    Confidential        Medium
Sales.Customers.first_name  Name            Confidential - GDPR Medium

このコマンドは、データベース内のすべての列の情報の種類と秘密度ラベルを取得します。 コマンドレットは、情報の種類または秘密度ラベル (またはその両方) が定義されている列のみを返します。

例 2: パスを指定して、データベースから 1 つの列の情報の種類と秘密度ラベルを取得する

PS C:\> Get-SqlSensitivityClassification -Path "SQLSERVER:\SQL\MyComputer\MainInstance\Databases\MyDatabase" -ColumnName "Sales.Customers.email"

Column                    InformationType SensitivityLabel SensitivityRank
------                    --------------- ---------------- ---------------
Sales.Customers.email     Contact Info    Confidential     Medium

このコマンドは、[パス] に指定されたデータベースの Sales.Customers.email 列の情報の種類と秘密度ラベルを取得します。

例 3: 現在のパス コンテキストを使用して、複数の列の秘密度ラベルと情報の種類を取得する

PS C:\> $columns = @("Sales.Customers.ip_address" , "Sales.Customers.email")
PS C:\> Set-Location "SQLSERVER:\SQL\MyComputer\MainInstance\Databases\MyDatabase"
PS SQLSERVER:\SQL\MyComputer\MainInstance> Get-SqlSensitivityClassification -ColumnName $columns
 WARNING: Using provider context. Server = MyComputer, Database = MyDatabase. 

Column                      InformationType SensitivityLabel SensitivityRank
------                      --------------- ---------------- ---------------
Sales.Customers.email       Contact Info    Confidential     Medium
Sales.Customers.ip_address

このコマンドは、データベースを検索するための列名と現在のパス コンテキストを含む配列引数を使用して、データベース内の複数の列の情報の種類と秘密度ラベルを取得します。

この例の Sales.Customers.ip_Addess など、情報の種類や秘密度ラベルがない列は、空の結果を返します。

パラメーター

-ColumnName

情報の種類と秘密度ラベルがフェッチされる列の名前。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る: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

-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

-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.Object