Поделиться через

New-SqlColumnEncryptionSettings

  • Ссылка
Модуль:
SQLServer

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

Синтаксис

New-SqlColumnEncryptionSettings
   [-ColumnName] <String>
   [-EncryptionType] <String>
   [[-EncryptionKey] <String>]
   [-ProgressAction <ActionPreference>]
   [<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>.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EncryptionKey

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

Тип:String
Position:2
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EncryptionType

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

  • Детерминированное шифрование для детерминированного шифрования
  • Случайное шифрование для случайного шифрования
  • Обычный текст, указывающий, что столбец не зашифрован.
Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ProgressAction

Определяет, как PowerShell реагирует на обновления хода выполнения, созданные скриптом, командлетом или поставщиком, например индикаторами хода выполнения, созданными командлетом Write-Progress. Командлет Write-Progress создает индикаторы хода выполнения, показывающие состояние команды.

Тип:ActionPreference
Aliases:proga
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

SqlColumnEncryptionSettings