Bagikan melalui

New-SqlColumnEncryptionSettings

Modul:
SqlServer Module

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

Sintaks

Default (Default) 

New-SqlColumnEncryptionSettings
    [-ColumnName] <String>
    [-EncryptionType] <String>
    [[-EncryptionKey] <String>]
    [<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 dbo.Person.LastName, menentukan kunci enkripsi deterministik dan enkripsi kolom yang dinamai MyCEK 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 dbo.Person.FirstName kolom, menentukan kolom tidak dienkripsi. Perintah menyimpan hasil dalam variabel bernama $EncryptionSettings.

Parameter

-ColumnName

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

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-EncryptionKey

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

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:2
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:1
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Output

SqlColumnEncryptionSettings