New-SqlColumnEncryptionSettings

モジュール:: SqlServer

1 つの列の暗号化に関する情報をカプセル化する SqlColumnEncryptionSettings オブジェクトを作成します。CEK と暗号化の種類を含みます。

構文

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

説明

New-SqlColumnEncryptionSettings コマンドレットは、SqlColumnEncryptionSettings オブジェクトを作成します。 SqlColumnEncryptionSettings オブジェクトは、暗号化の種類や列暗号化キーなど、1 つのデータベース列の 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
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EncryptionKey

列暗号化キーオブジェクトの名前を指定します。 EncryptionType パラメーター値が Plaintext に設定されている場合、この引数は使用できません。

型:	String
配置:	2
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EncryptionType

暗号化の種類を指定します。このパラメーターに使用できる値は次のとおりです。

決定論的、決定論的暗号化用
ランダム化(ランダム化された暗号化用)
列が暗号化されていないことを示すプレーンテキスト。

型:	String
配置:	1
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

出力

SqlColumnEncryptionSettings

SQLServer_Cmdlets