Get-SqlSensitivityClassification
取得資料庫中數據行的敏感度標籤和資訊類型。
語法
ByContext (預設值)
Get-SqlSensitivityClassification
[-ColumnName <String[]>]
[-SuppressProviderContextWarning]
[<CommonParameters>]
ByConnectionString
Get-SqlSensitivityClassification
-ConnectionString <String>
[-ColumnName <String[]>]
[<CommonParameters>]
ByConnectionParameters
Get-SqlSensitivityClassification
-ServerInstance <PSObject>
-DatabaseName <String>
[-ColumnName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
ByPath
Get-SqlSensitivityClassification
-Path <String>
[-ColumnName <String[]>]
[<CommonParameters>]
ByDBObject
Get-SqlSensitivityClassification
-InputObject <Database>
[-ColumnName <String[]>]
[<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[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ConnectionString
指定要連線到資料庫的連接字串。 如果此參數存在,則會忽略其他連接參數。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByConnectionString
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Credential
指定用來連線到資料庫的認證。
參數屬性
| 類型: | PSCredential |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByConnectionParameters
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DatabaseName
指定資料庫的名稱。 此 Cmdlet 會連線到 ServerInstance 參數中所指定實例中的這個資料庫。
如果未指定 DatabaseName 參數,則所使用的資料庫取決於目前路徑是否同時指定 SQLSERVER:\SQL 資料夾和資料庫名稱。 如果路徑同時指定 SQL 資料夾和資料庫名稱,此 Cmdlet 會連接到路徑中指定的資料庫。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByConnectionParameters
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-InputObject
指定 SQL Server 管理物件 (SMO) ,代表此 Cmdlet 所使用的資料庫。
參數屬性
| 類型: | Database |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByDBObject
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Path
指定此 Cmdlet 執行作業之 SQL Server 實例的路徑。 如果您未指定此參數的值,Cmdlet 會使用目前的工作位置。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByPath
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ServerInstance
指定伺服器實例的名稱(字串)或指定Database Engine實例名稱的SQL Server 管理物件 (SMO) 物件。 針對預設實例,只指定計算機名稱:MyComputer。 針對具名實例,請使用 ComputerName\InstanceName 格式。
參數屬性
| 類型: | PSObject |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByConnectionParameters
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SuppressProviderContextWarning
指出此 Cmdlet 會隱藏此 Cmdlet 在目前 SQLSERVER:\SQL 路徑設定中用於資料庫內容中的警告,以建立 Cmdlet 的資料庫內容。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByContext
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。