New-SqlColumnEncryptionSettings

Referencia

Módulo:: SQLServer

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

Syntax

New-SqlColumnEncryptionSettings
   [-ColumnName] <String>
   [-EncryptionType] <String>
   [[-EncryptionKey] <String>]
   [<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: Creación de 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 de columna y cifrado de columna determinista 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 dbo.Person.FirstName columna, 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 siguiente formato: [<schemaName>.]< tableName>.< columnName>.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 se establece en Plaintext.

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

-EncryptionType

Especifica el tipo de cifrado. Los valores permitidos para este parámetro son los siguientes:

Determinista, para el cifrado determinista
Aleatorio, para el cifrado aleatorio
Texto no cifrado, que indica que la columna no está cifrada.

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

Salidas

SqlColumnEncryptionSettings

SQLServer_Cmdlets