New-SqlColumnEncryptionSettings

参考

模块:: SQLServer

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

语法

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的列创建 SqlColumnEncryptionSettings 对象，指定为列命名MyCEK的确定性加密和列加密密钥。 The command stores the result in the variable named $EncryptionSettings.

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

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

此命令为dbo.Person.FirstName该列创建 SqlColumnEncryptionSettings 对象，指定该列未加密。 The command stores the result in the variable named $EncryptionSettings.

参数

-ColumnName

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionKey

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

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionType

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

确定性，用于确定性加密
随机化，用于随机加密
纯文本，指示列未加密。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

输出

SqlColumnEncryptionSettings

SQLServer_Cmdlets