New-SqlColumnEncryptionSettings

创建一个 SqlColumnEncryptionSettings 对象,该对象封装有关单个列加密的信息,包括 CEK 和加密类型。

语法

New-SqlColumnEncryptionSettings
   [-ColumnName] <String>
   [-EncryptionType] <String>
   [[-EncryptionKey] <String>]
   [-ProgressAction <ActionPreference>]
   [<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的列创建 SqlColumnEncryptionSettings 对象,并指定列的确定性加密和列加密密钥,该列名为 MyCEK。 该命令将结果存储在名为 $EncryptionSettings的变量中。

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

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

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

参数

-ColumnName

指定使用以下格式的数据库列的名称:[<schemaName>.]<tableName>。<columnName>。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-EncryptionKey

指定列加密密钥对象的名称。 如果将 EncryptionType 参数值设置为纯文本,则不允许此参数。

类型:String
Position:2
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EncryptionType

指定加密的类型。 此参数的可接受值为:

  • 确定性,用于确定性加密
  • 随机化,用于随机加密
  • 纯文本,指示列未加密。
类型:String
Position:1
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ProgressAction

确定 PowerShell 如何响应脚本、cmdlet 或提供程序生成的进度更新,例如由 Write-Progress cmdlet 生成的进度栏。 Write-Progress cmdlet 创建显示命令状态的进度栏。

类型:ActionPreference
别名:proga
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输出

SqlColumnEncryptionSettings