Get-SqlSensitivityClassification
取得資料庫中數據行的敏感度標籤和資訊類型。
語法
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