共用方式為


New-SqlCertificateStoreColumnMasterKeySettings

建立參考指定憑證的 SqlColumnMasterKeySettings 物件。

Syntax

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

Description

New-SqlCertificateStoreColumnMasterKeySettings Cmdlet 會建立SqlColumnMasterKeySettings物件,該物件會參考儲存在 Windows 憑證存放區中的指定憑證,此物件旨在作為Always Encrypted功能的資料行主要金鑰。

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

範例

範例 1:建立參考憑證的 SqlColumnMasterKeySettings 物件

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

此命令會建立參考 Windows 憑證存放區中憑證的 SqlColumnMasterKeySettings 物件。

範例 2:使用自動簽署屬性建立參考已啟用記憶體保護區的憑證的 SqlColumnMasterKeySettings 物件

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

此命令會在 Windows 憑證存放區中建立參考憑證的 SqlColumnMasterKeySettings 物件,以允許記憶體保護區計算。 由於未指定Signature,Cmdlet 會自動計算簽章,並填入SqlColumnMasterKeySettings物件的Signature屬性。

範例 3:建立參考已啟用記憶體保護區的憑證的 SqlColumnMasterKeySettings 物件

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

此命令會在 Windows 憑證存放區中建立參考憑證的 SqlColumnMasterKeySettings 物件,以允許記憶體保護區計算。 憑證屬性的簽 章是在 Signature 參數中指定。

參數

-AllowEnclaveComputations

指定資料行主要金鑰是否允許記憶體保護區計算。 如果指定參數,則允許伺服器端安全記憶體保護區對使用資料行主要金鑰保護的資料執行計算。 不適用於 SQL Server 2017 和舊版本。

Type:SwitchParameter
Position:2
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CertificateStoreLocation

指定包含憑證的憑證存放區位置。 此參數可接受的值為:

  • CurrentUser
  • LocalMachine
Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Signature

指定十六進位字串,這是資料行主要金鑰屬性的數位簽章。 用戶端驅動程式可以驗證簽章,以確保資料行主要金鑰屬性尚未遭到竄改。 只有在指定 AllowEnclaveComputations 時,才允許此參數。 如果指定 AllowEnclaveComputations ,但 未指定 Signature ,Cmdlet 會自動計算簽章,並填入新 SqlColumnMasterKeySettings 物件的 Signature 屬性。

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Thumbprint

指定憑證的指紋。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

輸出

SqlColumnMasterKeySettings