Bagikan melalui

New-SqlColumnEncryptionSettings

  • Referensi
Modul:
SQLServer

Membuat objek SqlColumnEncryptionSettings yang merangkum informasi tentang enkripsi kolom tunggal, termasuk CEK dan jenis enkripsi.

Sintaks

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

Deskripsi

cmdlet New-SqlColumnEncryptionSettings membuat objek SqlColumnEncryptionSettings . Objek SqlColumnEncryptionSettings merangkum informasi tentang pengaturan Always Encrypted untuk satu kolom database, termasuk jenis enkripsi dan kunci enkripsi kolom.

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

Contoh

Contoh 1: Membuat objek SqlColumnEncryptionSettings terenkripsi untuk kolom

PS C:\> $EncryptionSettings = New-SqlColumnEncryptionSettings dbo.Person.LastName "Deterministic" MyCEK

Perintah ini membuat objek SqlColumnEncryptionSettings untuk kolom bernama , menentukan kunci enkripsi deterministik dan enkripsi kolom bernama untuk kolom. Perintah menyimpan hasil dalam variabel bernama $EncryptionSettings.

Contoh 2: Membuat objek SqlColumnEncryptionSettings yang tidak terenkripsi untuk kolom

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

Perintah ini membuat objek SqlColumnEncryptionSettings untuk kolom dbo.Person.FirstName, menentukan kolom tidak dienkripsi. Perintah menyimpan hasil dalam variabel bernama $EncryptionSettings.

Parameter

-ColumnName

Menentukan nama kolom database yang menggunakan format berikut: [<schemaName>.]<tableName>.<columnName>.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-EncryptionKey

Menentukan nama objek kunci enkripsi kolom. Argumen ini tidak diperbolehkan jika nilai parameter EncryptionType diatur ke Plaintext.

Jenis:String
Position:2
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-EncryptionType

Menentukan jenis enkripsi. Nilai yang dapat diterima untuk parameter ini adalah:

  • Deterministik, untuk enkripsi deterministik
  • Diacak, untuk enkripsi acak
  • Teks biasa, menunjukkan bahwa kolom tidak dienkripsi.
Jenis:String
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-ProgressAction

Menentukan bagaimana PowerShell merespons pembaruan kemajuan yang dihasilkan oleh skrip, cmdlet, atau penyedia, seperti bilah kemajuan yang dihasilkan oleh cmdlet Write-Progress. cmdlet Write-Progress membuat bilah kemajuan yang memperlihatkan status perintah.

Jenis:ActionPreference
Alias:proga
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Output

SqlColumnEncryptionSettings