New-SqlColumnEncryptionSettings
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.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 パラメーター値がプレーンテキストに設定されている場合、この引数は使用できません。
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