Get-SqlSensitivityClassification

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

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

構文

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

説明

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

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

秘密度ラベルと列の情報の種類は、SQL Server Management Studio (SSMS) リリース 17.5 以降、または 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

このコマンドは、Path で指定されたデータベース内の列の情報の 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

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

Type:String[]
Position:Named
Default value:None
Required:False
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

-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

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