New-SqlColumnEncryptionSettings

  • リファレンス
モジュール:
SQLServer

CEK や暗号化の種類など、単一列の暗号化に関する情報をカプセル化する SqlColumnEncryptionSettings オブジェクトを作成します。

構文

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

説明

New-SqlColumnEncryptionSettings コマンドレットは、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"

このコマンドは、 列 オブジェクト SqlColumnEncryptionSettings を作成し、列が暗号化されていないことを指定します。 このコマンドは、結果を $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

-ProgressAction

スクリプト、コマンドレット、またはプロバイダーによって生成された進行状況の更新 (Write-Progress コマンドレットによって生成された進行状況バーなど) に対する PowerShell の応答方法を決定します。 Write-Progress コマンドレットは、コマンドの状態を示す進行状況バーを作成します。

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

出力

SqlColumnEncryptionSettings