New-SqlColumnEncryptionSettings
Создает объект SqlColumnEncryptionSettings, который инкапсулирует сведения о шифровании одного столбца, включая CEK и тип шифрования.
Синтаксис
Default (по умолчанию)
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.LastNameMyCEK столбца.
Команда сохраняет результат в переменной с именем $EncryptionSettings.
Пример 2. Создание незашифрованного объекта SqlColumnEncryptionSettings для столбца
PS C:\> $EncryptionSettings = New-SqlColumnEncryptionSettings dbo.Person.FirstName "Plaintext"
Эта команда создает объект SqlColumnEncryptionSettings для dbo.Person.FirstName столбца, указывая, что столбец не зашифрован. Команда сохраняет результат в переменной с именем $EncryptionSettings.
Параметры
-ColumnName
Указывает имя столбца базы данных, использующего следующий формат: [<schemaName>.]<tableName>.<columnName>.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EncryptionKey
Указывает имя объекта ключа шифрования столбца. Этот аргумент не допускается, если для значения параметра EncryptionType задано значение Plaintext.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 2 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EncryptionType
Указывает тип шифрования. Допустимые значения для этого параметра:
- Детерминированное шифрование для детерминированного шифрования
- Случайное шифрование для случайного шифрования
- Обычный текст, указывающий, что столбец не зашифрован.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.