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

このコマンドは、列に対して指定された決定論的暗号化キーと列暗号化キーMyCEKを指定して、名前付きのdbo.Person.LastName列に対して SqlColumnEncryptionSettings オブジェクトを作成します。このコマンドは、結果を名前付きの $EncryptionSettings変数に格納します。

例 2: 列の暗号化されていない SqlColumnEncryptionSettings オブジェクトを作成する

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

このコマンドは、列が暗号化されていないことを指定して、列の dbo.Person.FirstNameSqlColumnEncryptionSettings オブジェクトを作成します。このコマンドは、結果を名前付きの $EncryptionSettings変数に格納します。

パラメーター

-ColumnName

[schemaName.] という形式<を使用するデータベース列の名前を指定します>。<tableName>。<columnName>。

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

-EncryptionKey

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

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