New-SqlColumnEncryptionSettings

參考

模組:: SQLServer

建立 SqlColumnEncryptionSettings 物件，以封裝單一資料行加密的相關資訊，包括 CEK 和加密類型。

Syntax

New-SqlColumnEncryptionSettings
   [-ColumnName] <String>
   [-EncryptionType] <String>
   [[-EncryptionKey] <String>]
   [<CommonParameters>]

Description

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 > 。

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

-EncryptionKey

指定資料行加密金鑰物件的名稱。如果 EncryptionType 參數值設定為 PlaiNtext，則不允許此引數。

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