Bagikan melalui

New-SqlCertificateStoreColumnMasterKeySettings

  • Referensi
Modul:
SQLServer

Membuat objek SqlColumnMasterKeySettings yang mereferensikan sertifikat yang ditentukan.

Sintaks

New-SqlCertificateStoreColumnMasterKeySettings
   [-CertificateStoreLocation] <String>
   [-Thumbprint] <String>
   [[-Signature] <String>]
   [-AllowEnclaveComputations]
   [-ProgressAction <ActionPreference>]
   [<CommonParameters>]

Deskripsi

cmdlet New-SqlCertificateStoreColumnMasterKeySettings membuat objek SqlColumnMasterKeySettings yang mereferensikan sertifikat yang ditentukan, disimpan di Penyimpanan Sertifikat Windows, yang dimaksudkan untuk digunakan sebagai kunci master kolom untuk fitur Always Encrypted.

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

Contoh

Contoh 1: Membuat objek SqlColumnMasterKeySettings yang mereferensikan sertifikat

PS C:\> $CMKSettings = New-SqlCertificateStoreColumnMasterKeySettings -CertificateStoreLocation "CurrentUser" -CertificateThumbprint "f2260f28d909d21c642a3d8e0b45a830e79a1420"

Perintah ini membuat SqlColumnMasterKeySettings objek yang merujuk sertifikat di Windows Certificate Store.

Contoh 2: Membuat objek SqlColumnMasterKeySettings yang mereferensikan sertifikat berkemampuan enklave dengan properti yang ditandatangani secara otomatis

PS C:\>$CMKSettings = New-SqlCertificateStoreColumnMasterKeySettings -CertificateStoreLocation "CurrentUser" -CertificateThumbprint "f2260f28d909d21c642a3d8e0b45a830e79a1420" -AllowEnclaveComputations

Perintah ini membuat SqlColumnMasterKeySettings objek yang merujuk sertifikat di Windows Certificate Store yang memungkinkan komputasi enklave. Karena Tanda Tangan tidak ditentukan, cmdlet secara otomatis menghitung tanda tangan dan mengisi properti Tanda Tangan dari objek SqlColumnMasterKeySettings.

Contoh 3: Membuat objek SqlColumnMasterKeySettings yang mereferensikan sertifikat berkemampuan enklave

PS C:\>$CMKSettings = New-SqlCertificateStoreColumnMasterKeySettings -CertificateStoreLocation "CurrentUser" -CertificateThumbprint "f2260f28d909d21c642a3d8e0b45a830e79a1420" -AllowEnclaveComputations -Signature "0x19BEB4F27F582FDBBD0C7E5F92CF161D79D5E7F5A5183F9C8E710252E7028A3654FBEAF834EE45925024F1A32BD3C6D7D92B46E38690830E20E0777607B073E6665EB05E39263C02557D1208ACECB2251A108D0DEFC25232B67FD223C590258C817292FAFCE2388507812D64A0AEC9E546B0B8E4B2F3EA436053CB158F3CF478C5F5EDA511D0F752F60C3B129BF21356A93368FCC7FD6FAA8DB4E919EB551F375181CA3F4D0404A811C99BD2C8D10C0003AC12B138371F2D76611768B4E84D44116C42F00D679B36D41FBD9467B58291B1F4348C7B422793DA0614EF980CA0A7F42B6D627AFA5A753F0869D2C2F9B0FD38289D5433CE9266C6F867334654BE12"

Perintah ini membuat SqlColumnMasterKeySettings objek yang merujuk sertifikat di Windows Certificate Store yang memungkinkan komputasi enklave. Tanda tangan properti sertifikat ditentukan dalam parameter Tanda Tangan .

Parameter

-AllowEnclaveComputations

Menentukan apakah kunci master kolom memungkinkan komputasi enklave. Jika parameter ditentukan, enklave aman sisi server akan diizinkan untuk melakukan komputasi pada data yang dilindungi dengan kunci master kolom. Tidak valid untuk SQL Server 2017 dan versi yang lebih lama.

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

-CertificateStoreLocation

Menentukan lokasi penyimpanan sertifikat, yang berisi sertifikat. Nilai yang dapat diterima untuk parameter ini adalah:

  • CurrentUser
  • LocalMachine
Jenis:String
Position:0
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

-Signature

Menentukan string heksadesimal yang merupakan tanda tangan digital properti kunci master kolom. Driver klien dapat memverifikasi tanda tangan untuk memastikan properti kunci master kolom belum dirusak. Parameter ini diperbolehkan hanya jika AllowEnclaveComputations ditentukan. Jika AllowEnclaveComputations ditentukan, tetapi Signature tidak, cmdlet secara otomatis menghitung tanda tangan dan mengisi properti Tanda Tangan dari objek SqlColumnMasterKeySettings baru.

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

-Thumbprint

Menentukan thumbprint sertifikat.

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

Output

SqlColumnMasterKeySettings