Compartir a través de

Get-SqlSensitivityClassification

  • Referencia
Módulo:
SQLServer

Obtenga la etiqueta de confidencialidad y el tipo de información de las columnas de la base de datos.

Sintaxis

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

El cmdlet Get-SqlSensitivityClassification obtiene las etiquetas de confidencialidad y los tipos de información de las columnas de la base de datos.

Las etiquetas de confidencialidad y los tipos de información de las columnas también se pueden ver mediante SQL Server Management Studio (SSMS) versión 17.5 y posteriores, o bien la vista de catálogo propiedades extendidas de .

Las etiquetas de confidencialidad y los tipos de información de columnas se pueden establecer mediante SQL Server Management Studio (SSMS) versión 17.5 y posteriores, o con el cmdlet set-SqlSensitivityClassification .

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

Ejemplos

Ejemplo 1: Obtener todos los tipos de información y etiquetas de confidencialidad de una base de datos mediante la autenticación de 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

Este comando obtiene el tipo de información y la etiqueta de confidencialidad de todas las columnas de la base de datos. El cmdlet devuelve solo las columnas que tienen un tipo de información o una etiqueta de confidencialidad (o ambas) definidas.

Ejemplo 2: Obtener el tipo de información y la etiqueta de confidencialidad de una sola columna de la base de datos proporcionando la ruta de acceso

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

Este comando obtiene el tipo de información y la etiqueta de confidencialidad de la columna Sales.Customers.email de la base de datos proporcionada en la ruta de acceso.

Ejemplo 3: Obtención de etiquetas de confidencialidad y tipos de información de varias columnas mediante el contexto de ruta de acceso actual

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

Este comando obtiene el tipo de información y la etiqueta de confidencialidad de varias columnas de la base de datos mediante y el argumento array que contiene los nombres de columna y el contexto de ruta de acceso actual para localizar la base de datos.

Las columnas que no tienen ningún tipo de información o etiqueta de confidencialidad, como Sales.Customers.ip_Addess en el ejemplo, devolverán resultados vacíos.

Parámetros

-ColumnName

Nombres de columnas para las que se captura el tipo de información y la etiqueta de confidencialidad.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ConnectionString

Especifica una cadena de conexión para conectarse a la base de datos. Si este parámetro está presente, se omitirán otros parámetros de conexión.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Especifica una credencial usada para conectarse a la base de datos.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatabaseName

Especifica el nombre de una base de datos. Este cmdlet se conecta a esta base de datos en la instancia especificada en el parámetro ServerInstance.

Si no se especifica el parámetro DatabaseName, la base de datos que se usa depende de si la ruta de acceso actual especifica tanto la carpeta SQLSERVER:\SQL como un nombre de base de datos. Si la ruta de acceso especifica la carpeta SQL y un nombre de base de datos, este cmdlet se conecta a la base de datos especificada en la ruta de acceso.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifica un objeto de administración de SQL Server (SMO) que representa la base de datos que usa este cmdlet.

Tipo:Database
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Path

Especifica la ruta de acceso a la instancia de SQL Server en la que este cmdlet ejecuta la operación. Si no especifica un valor para este parámetro, el cmdlet usa la ubicación de trabajo actual.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ProgressAction

Determina cómo Responde PowerShell a las actualizaciones de progreso generadas por un script, cmdlet o proveedor, como las barras de progreso generadas por el cmdlet Write-Progress. El cmdlet Write-Progress crea barras de progreso que muestran el estado de un comando.

Tipo:ActionPreference
Alias:proga
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServerInstance

Especifica el nombre de la instancia del servidor (una cadena) o el objeto Objetos de administración de SQL Server (SMO) que especifica el nombre de una instancia del motor de base de datos. Para las instancias predeterminadas, especifique solo el nombre del equipo: MyComputer. Para las instancias con nombre, use el formato NombreDeEquipo\NombreDeInstancia.

Tipo:PSObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SuppressProviderContextWarning

Indica que este cmdlet suprime la advertencia de que este cmdlet ha usado en el contexto de base de datos de la configuración actual de la ruta de acceso SQLSERVER:\SQL para establecer el contexto de la base de datos para el cmdlet.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

System.String[]

Microsoft.SqlServer.Management.Smo.Database

Salidas

System.Object