共用方式為

New-SqlColumnEncryptionSettings

模組:
SqlServer Module

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

語法

Default (預設值) 

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 物件，並指定數據行名為 MyCEK 的決定性加密和數據行加密密鑰。 命令會將結果儲存在名為 $EncryptionSettings的變數中。

範例 2：為數據行建立未加密的 SqlColumnEncryptionSettings 物件

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

此命令會為數據行建立 dbo.Person.FirstName 物件，並指定數據行未加密。 命令會將結果儲存在名為 $EncryptionSettings的變數中。

參數

-ColumnName

指定使用下列格式的資料庫數據行名稱：[<schemaName>.]<tableName>。<columnName>。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EncryptionKey

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

參數屬性

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