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

此命令获取 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

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

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

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

-InputObject

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

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

-Path

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

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

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

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

相关链接

• SQL 数据发现和分类