New-SqlCngColumnMasterKeySettings

Erstellt ein SqlColumnMasterKeySettings Objekt, das einen asymmetrischen Schlüssel beschreibt, der in einem Schlüsselspeicher gespeichert ist, der die CNG-API unterstützt.

Syntax

New-SqlCngColumnMasterKeySettings
   [-CngProviderName] <String>
   [-KeyName] <String>
   [-ProgressAction <ActionPreference>]
   [<CommonParameters>]

Beschreibung

Das cmdlet New-SqlCngColumnMasterKeySettings erstellt ein SqlColumnMasterKeySettings-Objekt. Das SqlColumnMasterKeySettings--Objekts verweist auf einen Schlüssel, der in einem Schlüsselspeicher gespeichert ist, der die Kryptografie-API der nächsten Generation (CNG) unterstützt. Das SqlColumnMasterKeySettings- objekt verfügt über zwei Eigenschaften: KeyStoreProviderName und KeyPath-. Mit diesem Cmdlet wird die KeyStoreProviderName-Eigenschaft so festgelegt, dass der Name des Spaltenmasterschlüsselspeicheranbieters für CNG enthalten ist. Anschließend wird der Wert der KeyPath-Eigenschaft generiert und festgelegt, um auf den angegebenen Schlüssel zu verweisen.

Beispiele

Beispiel 1: Erstellen eines SqlColumnMasterKeySettings-Objekts

PS C:\> $CMKSettings = New-SqlCngColumnMasterKeySettings -CngProviderName "Microsoft Software Key Storage Provider" -KeyName "AlwaysEncryptedKey"

Mit diesem Befehl wird ein SqlColumnMasterKeySettings Objekt erstellt, das auf einen Schlüssel in einem Schlüsselspeicher verweist, der von einem CNG-Anbieter namens Microsoft Software Key Storage Provider gekapselt wird. Der Befehl speichert dann das Ergebnis des Vorgangs in der Variablen mit dem Namen $CMKSettings.

Parameter

-CngProviderName

Gibt den Namen des CNG-Anbieters für den Schlüsselspeicher an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KeyName

Gibt den Namen des Schlüssels im Schlüsselspeicher an.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProgressAction

Bestimmt, wie PowerShell auf Statusaktualisierungen reagiert, die von einem Skript, Cmdlet oder Anbieter generiert werden, z. B. auf die Statusanzeigen, die vom Cmdlet Write-Progress generiert werden. Das Cmdlet Write-Progress erstellt Statusanzeigen, die den Status eines Befehls anzeigen.

Typ:ActionPreference
Aliase:proga
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

SqlColumnMasterKeySettings