New-SqlColumnEncryptionSettings
建立 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