New-SqlColumnEncryptionSettings

  • Referencia
Módulo:
SQLServer

Crea un objeto SqlColumnEncryptionSettings que encapsula información sobre el cifrado de una sola columna, incluido el CEK y el tipo de cifrado.

Sintaxis

New-SqlColumnEncryptionSettings
   [-ColumnName] <String>
   [-EncryptionType] <String>
   [[-EncryptionKey] <String>]
   [-ProgressAction <ActionPreference>]
   [<CommonParameters>]

Description

El cmdlet New-SqlColumnEncryptionSettings crea un objeto SqlColumnEncryptionSettings. El objeto SqlColumnEncryptionSettings encapsula información sobre la configuración de Always Encrypted para una sola columna de base de datos, incluido el tipo de cifrado y la clave de cifrado de columna.

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

Ejemplos

Ejemplo 1: Crear un objeto SqlColumnEncryptionSettings cifrado para una columna

PS C:\> $EncryptionSettings = New-SqlColumnEncryptionSettings dbo.Person.LastName "Deterministic" MyCEK

Este comando crea un objeto SqlColumnEncryptionSettings para la columna denominada dbo.Person.LastName, especificando la clave de cifrado determinista y cifrado de columna denominada MyCEK para la columna. El comando almacena el resultado en la variable denominada $EncryptionSettings.

Ejemplo 2: Crear un objeto SqlColumnEncryptionSettings sin cifrar para una columna

PS C:\> $EncryptionSettings = New-SqlColumnEncryptionSettings dbo.Person.FirstName "Plaintext"

Este comando crea un objeto SqlColumnEncryptionSettings para la columna dbo.Person.FirstName, especificando que la columna no está cifrada. El comando almacena el resultado en la variable denominada $EncryptionSettings.

Parámetros

-ColumnName

Especifica el nombre de la columna de base de datos que usa el formato siguiente: [<schemaName>.]<tableName>.<columnName>.

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

-EncryptionKey

Especifica el nombre del objeto de clave de cifrado de columna. Este argumento no se permite si el valor del parámetro EncryptionType está establecido en Plaintext.

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

-EncryptionType

Especifica el tipo de cifrado. Los valores aceptables para este parámetro son:

  • Determinista, para el cifrado determinista
  • Aleatorio para el cifrado aleatorio
  • Texto sin formato, que indica que la columna no está cifrada.
Tipo:String
Posición:1
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

Salidas

SqlColumnEncryptionSettings