Get-SqlSensitivityClassification
Obtenga la etiqueta de confidencialidad y el tipo de información de las columnas de la base de datos.
Sintaxis
ByContext (Es el valor predeterminado).
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
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 la versión 17.5 y posteriores de SQL Server Management Studio (SSMS) o la vista de catálogo Propiedades extendidas.
Las etiquetas de confidencialidad y los tipos de información de las columnas se pueden establecer mediante la versión 17.5 y posteriores de SQL Server Management Studio (SSMS) 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 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.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ByConnectionString
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Credential
Especifica una credencial usada para conectarse a la base de datos.
Propiedades del parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ByConnectionParameters
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ByConnectionParameters
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-InputObject
Especifica un objeto de administración de SQL Server (SMO) que representa la base de datos que usa este cmdlet.
Propiedades del parámetro
| Tipo: | Database |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ByDBObject
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ByPath
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | PSObject |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ByConnectionParameters
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ByContext
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.