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的确定性加密和列加密密钥。 该命令将结果存储在名为 <a0/a0> 的变量中。

示例 2:为列创建未加密的 SqlColumnEncryptionSettings 对象

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

此命令为该列创建 dbo.Person.FirstName 对象,指定该列未加密。 该命令将结果存储在名为 <a0/a0> 的变量中。

参数

-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

输出

SqlColumnEncryptionSettings