New-SqlColumnEncryptionSettings
1 つの列の暗号化に関する情報をカプセル化する SqlColumnEncryptionSettings オブジェクトを作成します。CEK と暗号化の種類を含みます。
構文
Default (既定)
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 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EncryptionKey
列暗号化キー オブジェクトの名前を指定します。 EncryptionType パラメーター値が Plaintext に設定されている場合、この引数は使用できません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EncryptionType
暗号化の種類を指定します。 このパラメーターに使用できる値は次のとおりです。
- 決定論的、決定論的暗号化用
- ランダム化(ランダム化された暗号化用)
- 列が暗号化されていないことを示すプレーンテキスト。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。