共用方式為

New-SqlColumnEncryptionSettings

  • 參考
模組:
SQLServer

建立 SqlColumnEncryptionSettings 物件，以封裝單一數據行加密的相關信息，包括 CEK 和加密類型。

語法

New-SqlColumnEncryptionSettings
   [-ColumnName] <String>
   [-EncryptionType] <String>
   [[-EncryptionKey] <String>]
   [-ProgressAction <ActionPreference>]
   [<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>。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-EncryptionKey

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

類型: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