Condividi tramite

New-SqlCngColumnMasterKeySettings

  • Riferimento
Modulo:
SQLServer

Crea un SqlColumnMasterKeySettings oggetto che descrive una chiave asimmetrica archiviata in un archivio chiavi che supporta l'API CNG.

Sintassi

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

Descrizione

Il cmdlet New-SqlCngColumnMasterKeySettings di crea un oggetto SqlColumnMasterKeySettings. L'oggetto SqlColumnMasterKeySettings fa riferimento a una chiave archiviata in un archivio chiavi che supporta l'API Cryptography Next Generation (CNG). L'oggetto SqlColumnMasterKeySettings ha due proprietà: KeyStoreProviderName e KeyPath. Questo cmdlet imposta la proprietà KeyStoreProviderName contenente il nome del provider dell'archivio chiavi master della colonna per CNG, quindi genera e imposta il valore della proprietà KeyPath per fare riferimento alla chiave specificata.

Esempio

Esempio 1: Creare un oggetto SqlColumnMasterKeySettings

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

Questo comando crea un SqlColumnMasterKeySettings oggetto che fa riferimento a una chiave in un archivio chiavi incapsulato da un provider CNG denominato Provider di archiviazione chiavi software Microsoft. Il comando archivia quindi il risultato dell'operazione nella variabile denominata $CMKSettings.

Parametri

-CngProviderName

Specifica il nome del provider CNG per l'archivio chiavi.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-KeyName

Specifica il nome della chiave nell'archivio chiavi.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProgressAction

Determina in che modo PowerShell risponde agli aggiornamenti dello stato generati da uno script, un cmdlet o un provider, ad esempio le barre di stato generate dal cmdlet Write-Progress. Il cmdlet Write-Progress crea barre di stato che mostrano lo stato di un comando.

Tipo:ActionPreference
Alias:proga
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Output

SqlColumnMasterKeySettings