Set-SqlSensitivityClassification

  • Referencia
Módulo:
SQLServer

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

Sintaxis

Set-SqlSensitivityClassification
   -ColumnName <String[]>
   [-SuppressProviderContextWarning]
   [-SensitivityRank <SensitivityRank>]
   [-ProgressAction <ActionPreference>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -ConnectionString <String>
   [-SensitivityRank <SensitivityRank>]
   [-ProgressAction <ActionPreference>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -ServerInstance <PSObject>
   -DatabaseName <String>
   [-Credential <PSCredential>]
   [-SensitivityRank <SensitivityRank>]
   [-ProgressAction <ActionPreference>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -Path <String>
   [-SensitivityRank <SensitivityRank>]
   [-ProgressAction <ActionPreference>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -InputObject <Database>
   [-SensitivityRank <SensitivityRank>]
   [-ProgressAction <ActionPreference>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]

Description

El cmdlet Set-SqlSensitivityClassification establece el tipo de información o la etiqueta de confidencialidad de las columnas de la base de datos.

El tipo de información y la etiqueta de confidencialidad y el tipo de información de las columnas también se establecen mediante SQL Server Management Studio (SSMS) versión 17.5 y posteriores.

El tipo de información y la etiqueta de confidencialidad y el tipo de información de las columnas se pueden ver mediante SQL Server Management Studio (SSMS) versión 17.5 y posteriores, la vista de catálogo de propiedades extendidas de , o el cmdlet Get-SqlSensitivityClassification.

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

Ejemplos

Ejemplo 1: Establecer el tipo de información y la etiqueta de confidencialidad en una sola columna mediante la autenticación de Windows

PS C:\> Set-SqlSensitivityClassification -ServerInstance "MyComputer\MainInstance" -Database "myDatabase" -ColumnName "Sales.Customers.first_name" -InformationType "Name" -SensitivityLabel "Confidential - GDPR" -SensitivityRank "Low"

Column                      InformationType SensitivityLabel    SensitivityRank
------                      --------------- ----------------    ---------------
Sales.Customers.first_name  Name            Confidential - GDPR Low

Establezca el tipo de información y la etiqueta de confidencialidad de la columna Sales.Customers.first_name en Name y Confidential - GDPR respectivamente. Los valores de tipo de información y etiqueta de confidencialidad se limitan a los valores predeterminados que se proporcionan a continuación y se pueden obtener mediante la tecla Tab.

Ejemplo 2: Establecimiento del tipo de información de una sola columna mediante la autenticación de Windows

PS C:\> Set-SqlSensitivityClassification -ServerInstance "MyComputer\MainInstance" -Database "myDatabase" -ColumnName "Sales.Customers.first_name" -InformationType "Personal"

Column                      InformationType SensitivityLabel SensitivityRank
------                      --------------- ---------------- ---------------
Sales.Customers.first_name  Personal

Establezca el tipo de información de la columna Sales.Customers.first_name en Personal. La etiqueta de confidencialidad se anulará si se estableció anteriormente.

Ejemplo 3: Establecimiento de la etiqueta de confidencialidad de una sola columna mediante parámetros de conexión

PS C:\> Set-SqlSensitivityClassification -ServerInstance "MyComputer\MainInstance" -Database "myDatabase" -Credential (Get-Credential "sa") -ColumnName "Sales.Customers.ip_address" -SensitivityLabel "Confidential"

Column                      InformationType SensitivityLabel SensitivityRank
------                      --------------- ---------------- ---------------
Sales.Customers.ip_address                  Confidential

Establezca la etiqueta de confidencialidad de la columna Sales.Customers.ip_address en Confidential mediante el inicio de sesión de SQL Server. El tipo de información de esta columna permanece sin establecer. Este comando le pide una contraseña para completar la autenticación.

Ejemplo 4: Establecimiento del tipo de información y la etiqueta de clasificación de varias columnas mediante el contexto de ruta de acceso actual

PS C:\> $columns = @("Sales.Customers.first_name" , "Sales.Customers.last_name")
PS C:\> Set-Location "SQLSERVER:\SQL\MyComputer\MainInstance\Databases\MyDatabase"
PS SQLSERVER:\SQL\MyComputer\MainInstance> Set-SqlSensitivityClassification -ColumnName $columns -InformationType "Name" -SensitivityLabel "Confidential - GDPR" -SensitivityRank "Critical"
 WARNING: Using provider context. Server = MyComputer, Database = MyDatabase.

Column                      InformationType SensitivityLabel    SensitivityRank
------                      --------------- ----------------    ---------------
Sales.Customers.first_name  Name            Confidential - GDPR Critical
Sales.Customers.last_name   Name            Confidential - GDPR Critical

Establezca el tipo de información y la etiqueta de confidencialidad de la columna Sales.Customers.first_name y Sales.Customers.last_name proporcionando una matriz de nombres de columna como argumento para el cmdlet. Todas las columnas recibirán el mismo tipo de información y etiqueta de confidencialidad. La información de conexión de base de datos se toma del contexto creado por Set-Location.

Parámetros

-ColumnName

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

Tipo:String[]
Alias:Column
Posición:Named
Valor predeterminado:None
Requerido:True
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

-InformationType

Nombre que describe el tipo de información almacenado en las columnas. Debe proporcionar un valor para SensitivityLabel, InformationType o ambos. Los valores posibles son limitados y no se pueden extender.

Tipo:String
Valores aceptados:Networking, Contact Info, Credentials, Credit Card, Banking, Financial, Other, Name, National ID, SSN, Health, Date Of Birth
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
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

-SensitivityLabel

Nombre que describe la confidencialidad de los datos almacenados en las columnas. Debe proporcionar un valor para SensitivityLabel, InformationType o ambos. Los valores posibles son limitados y no se pueden extender.

Tipo:String
Valores aceptados:Public, General, Confidential, Confidential - GDPR, Highly Confidential, Highly Confidential - GDPR
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SensitivityRank

Identificador basado en un conjunto predefinido de valores que definen la clasificación de confidencialidad. Otros servicios como Advanced Threat Protection pueden usarse para detectar anomalías en función de su clasificación.

Tipo:SensitivityRank
Valores aceptados:None, Low, Medium, High, Critical
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
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

System.String

Salidas

System.Object