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

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

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

沒有資訊類型或敏感度標籤的資料行，例如範例中的 Sales.Customers.ip_Addess，將會傳回空的結果。

參數

-ColumnName

擷取資訊類型和敏感度標籤之數據行的名稱。。

類型:	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

指定此 Cmdlet 執行作業之 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

指定伺服器實例的名稱（字串）或指定Database Engine實例名稱的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 資料探索和分類