New-SqlColumnEncryptionSettings
创建一个 SqlColumnEncryptionSettings 对象,该对象封装有关单个列加密的信息,包括 CEK 和加密类型。
语法
Default (默认值)
New-SqlColumnEncryptionSettings
[-ColumnName] <String>
[-EncryptionType] <String>
[[-EncryptionKey] <String>]
[<CommonParameters>]
说明
New-SqlColumnEncryptionSettings cmdlet 创建 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
此命令为名为列的列创建 dbo.Person.LastName 对象,并指定为该列命名MyCEK的确定性加密和列加密密钥。
该命令将结果存储在名为 <
示例 2:为列创建未加密的 SqlColumnEncryptionSettings 对象
PS C:\> $EncryptionSettings = New-SqlColumnEncryptionSettings dbo.Person.FirstName "Plaintext"
此命令为该列创建 dbo.Person.FirstName 对象,指定该列未加密。 该命令将结果存储在名为 <
参数
-ColumnName
指定使用以下格式的数据库列的名称:[<schemaName>.]<tableName>。<columnName>。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-EncryptionKey
指定列加密密钥对象的名称。 如果将 EncryptionType 参数值设置为纯文本,则不允许此参数。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 2 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-EncryptionType
指定加密的类型。 此参数的可接受值为:
- 确定性,用于确定性加密
- 随机化,用于随机加密
- 纯文本,指示列未加密。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。