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

还可以使用 SQL Server Management Studio(SSMS) 版本 17.5 及更高版本来设置信息类型和敏感度标签和信息类型。

可以使用 SQL Server Management Studio (SSMS) 版本 17.5 及更高版本、扩展属性目录视图Get-SqlSensitivityClassification cmdlet 查看列的信息类型和敏感度标签和信息类型。

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

示例

示例 1:使用 Windows 身份验证在单个列上设置信息类型和敏感度标签

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 的信息类型和敏感度标签分别设置为 NameConfidential - 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:使用连接参数设置单个列的敏感度标签

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

通过将列名数组作为参数提供给 cmdlet 来设置列 Sales.Customers.first_nameSales.Customers.last_name 的信息类型和敏感度标签。 所有列都将接收相同的信息类型和敏感度标签。 数据库连接信息取自由 Set-Location创建的上下文。

参数

-ColumnName

为其设置了信息类型和敏感度标签的列的名称(s)。

类型:String[]
别名:Column
Position:Named
默认值:None
必需:True
接受管道输入: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

-InformationType

描述存储在列中的信息类型的名称。 必须为 SensitivityLabel、InformationType 或两者提供值。 可能的值是有限的,不能扩展。

类型:String
接受的值:Networking, Contact Info, Credentials, Credit Card, Banking, Financial, Other, Name, National ID, SSN, Health, Date Of Birth
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符: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

-SensitivityLabel

描述存储在列中的数据的敏感度的名称。 必须为 SensitivityLabel、InformationType 或两者提供值。 可能的值是有限的,不能扩展。

类型:String
接受的值:Public, General, Confidential, Confidential - GDPR, Highly Confidential, Highly Confidential - GDPR
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-SensitivityRank

基于定义敏感度排名的预定义值集的标识符。 其他服务可以使用高级威胁防护等服务根据其排名来检测异常

类型:SensitivityRank
接受的值:None, Low, Medium, High, Critical
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符: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.String

输出

System.Object