Get-SqlSensitivityClassification

取得資料庫中資料行的敏感度標籤和資訊類型。

Syntax

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

Description

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

此命令會使用 和 array 引數,取得資料庫中多個資料行的資訊類型和敏感度標籤,其中包含要尋找資料庫的資料行名稱和目前路徑內容。

沒有資訊類型或敏感度標籤的資料行,例如 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

指定執行此 Cmdlet 之SQL Server實例的路徑。 如果您未指定此參數的值,Cmdlet 會使用目前的工作位置。

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

-ServerInstance

指定 (字串) 或SQL Server管理物件 (SMO) 物件的名稱,指定 Database Engine 實例的名稱。 針對預設實例,只指定電腦名稱稱: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