New-SqlColumnEncryptionSettings

Ссылка

Модуль:: SQLServer

Создает объект SqlColumnEncryptionSettings, который инкапсулирует сведения о шифровании одного столбца, включая CEK и тип шифрования.

Синтаксис

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

Описание

Командлет New-SqlColumnEncryptionSettings создает объект SqlColumnEncryptionSettings . Объект SqlColumnEncryptionSettings инкапсулирует сведения о параметрах Always Encrypted для отдельных столбцов базы данных, включая тип шифрования и ключ шифрования столбцов.

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

Примеры

Пример 1. Создание зашифрованного объекта SqlColumnEncryptionSettings для столбца

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

Эта команда создает объект SqlColumnEncryptionSettings для столбца с именем dbo.Person.LastName, указав детерминированное шифрование и ключ шифрования столбца, названные MyCEK для столбца. Команда сохраняет результат в переменной с именем $EncryptionSettings.

Пример 2. Создание незашифрованного объекта SqlColumnEncryptionSettings для столбца

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

Эта команда создает объект SqlColumnEncryptionSettings для dbo.Person.FirstName столбца, указывая, что столбец не зашифрован. Команда сохраняет результат в переменной с именем $EncryptionSettings.

Параметры

-ColumnName

Указывает имя столбца базы данных, использующего следующий формат: [<schemaName>.]< tableName>.< columnName>.

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

-EncryptionKey

Указывает имя объекта ключа шифрования столбца. Этот аргумент не допускается, если для параметра EncryptionType задано значение Plaintext.

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

-EncryptionType

Указывает тип шифрования. Допустимые значения для этого параметра:

Детерминированное шифрование для детерминированного шифрования
Случайное шифрование для случайного шифрования
Открытый текст, указывающий, что столбец не зашифрован.

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

Выходные данные

SqlColumnEncryptionSettings

SQLServer_Cmdlets