Get-SqlSensitivityClassification

模块:

SQLServer

获取数据库中列的敏感度标签和信息类型。

语法

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 cmdlet 获取数据库中列的敏感度标签和信息类型。

还可以使用 SQL Server Management Studio （SSMS） 版本 17.5 及更高版本查看列的敏感度标签和信息类型，或者 扩展属性目录视图。

可以使用 SQL Server Management Studio （SSMS） 版本 17.5 及更高版本或 Set-SqlSensitivityClassification cmdlet 来设置列的敏感度标签和信息类型。

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

此命令获取数据库中所有列的信息类型和敏感度标签。 该 cmdlet 仅返回定义了信息类型或敏感度标签（或两者）的列。

示例 2：通过提供路径从数据库获取单列的信息类型和敏感度标签

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

为其提取信息类型和敏感度标签的列的名称（s）。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ConnectionString

指定要连接到数据库的连接字符串。 如果存在此参数，将忽略其他连接参数。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Credential

指定用于连接到数据库的凭据。

类型:	PSCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DatabaseName

指定数据库的名称。 此 cmdlet 连接到 ServerInstance 参数中指定的实例中的此数据库。

如果未指定 DatabaseName 参数，则使用的数据库取决于当前路径是否同时指定 SQLSERVER：\SQL 文件夹和数据库名称。 如果路径同时指定 SQL 文件夹和数据库名称，则此 cmdlet 将连接到路径中指定的数据库。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-InputObject

指定一个 SQL Server 管理对象（SMO），该对象表示此 cmdlet 使用的数据库。

类型:	Database
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Path

指定运行该操作的 SQL Server 实例的路径。 如果未为此参数指定值，cmdlet 将使用当前工作位置。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ProgressAction

确定 PowerShell 如何响应脚本、cmdlet 或提供程序生成的进度更新，例如由 Write-Progress cmdlet 生成的进度栏。 Write-Progress cmdlet 创建显示命令状态的进度栏。

类型:	ActionPreference
别名:	proga
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ServerInstance

指定服务器实例（字符串）或 SQL Server 管理对象（SMO）对象的名称，该对象指定数据库引擎实例的名称。 对于默认实例，仅指定计算机名称：MyComputer。 对于命名实例，请使用 ComputerName\InstanceName 格式。

类型:	PSObject
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SuppressProviderContextWarning

指示此 cmdlet 禁止显示此 cmdlet 在当前 SQLSERVER：\SQL 路径设置中使用的数据库上下文中用于为 cmdlet 建立数据库上下文的警告。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

System.String[]

Microsoft.SqlServer.Management.Smo.Database

输出

System.Object

相关链接

• SQL 数据发现和分类