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.

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

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 la vista de catálogo Propiedades extendidas.

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 las etiquetas de confidencialidad de una base de datos mediante 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 Sales.Customers.email columna 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-Credential

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 la carpeta SQLSERVER:\SQL y 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.

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

-InputObject

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

Type:Database
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-ServerInstance

Especifica el nombre de la instancia del servidor (una cadena) o SQL Server objeto Objetos de administración (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.

Type:PSObject
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

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

Entradas

System.String[]

Microsoft.SqlServer.Management.Smo.Database

Salidas

System.Object