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
Default (Standardwert)
New-SqlCngColumnMasterKeySettings
[-CngProviderName] <String>
[-KeyName] <String>
[<CommonParameters>]
Beschreibung
Das Cmdlet New-SqlCngColumnMasterKeySettings erstellt ein SqlColumnMasterKeySettings-Objekt . Das SqlColumnMasterKeySettings-Objekt 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 festgelegt, dass die KeyStoreProviderName-Eigenschaft den Namen des Spaltenmasterschlüsselspeicheranbieters für CNG enthält. 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"
Dieser Befehl erstellt ein SqlColumnMasterKeySettings -Objekt, 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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-KeyName
Gibt den Namen des Schlüssels im Schlüsselspeicher an.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.