Condividi tramite

New-SqlColumnEncryptionSettings

  • Riferimento
Modulo:
SQLServer

Crea un oggetto SqlColumnEncryptionSettings che incapsula informazioni sulla crittografia di una singola colonna, tra cui CEK e tipo di crittografia.

Sintassi

New-SqlColumnEncryptionSettings
   [-ColumnName] <String>
   [-EncryptionType] <String>
   [[-EncryptionKey] <String>]
   [-ProgressAction <ActionPreference>]
   [<CommonParameters>]

Descrizione

Il cmdlet New-SqlColumnEncryptionSettings crea un oggetto SqlColumnEncryptionSettings. Il SqlColumnEncryptionSettings oggetto incapsula informazioni sulle impostazioni di Always Encrypted per una singola colonna di database, inclusi il tipo di crittografia e la chiave di crittografia della colonna.

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

Esempio

Esempio 1: Creare un oggetto SqlColumnEncryptionSettings crittografato per una colonna

PS C:\> $EncryptionSettings = New-SqlColumnEncryptionSettings dbo.Person.LastName "Deterministic" MyCEK

Questo comando crea un Oggetto SqlColumnEncryptionSettings per la colonna denominata dbo.Person.LastName, specificando la crittografia deterministica e la chiave di crittografia della colonna denominata MyCEK per la colonna. Il comando archivia il risultato nella variabile denominata $EncryptionSettings.

Esempio 2: Creare un oggetto SqlColumnEncryptionSettings non crittografato per una colonna

PS C:\> $EncryptionSettings = New-SqlColumnEncryptionSettings dbo.Person.FirstName "Plaintext"

Questo comando crea un oggetto SqlColumnEncryptionSettings per la colonna dbo.Person.FirstName, specificando che la colonna non è crittografata. Il comando archivia il risultato nella variabile denominata $EncryptionSettings.

Parametri

-ColumnName

Specifica il nome della colonna di database che utilizza il formato seguente: [<schemaName>.]<tableName>.<columnName>.

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

-EncryptionKey

Specifica il nome dell'oggetto chiave di crittografia della colonna. Questo argomento non è consentito se il valore del parametro EncryptionType è impostato su Testo non crittografato.

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

-EncryptionType

Specifica il tipo di crittografia. I valori accettabili per questo parametro sono:

  • Deterministico, per la crittografia deterministica
  • Casuale, per la crittografia casuale
  • Testo non crittografato, che indica che la colonna non è crittografata.
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

SqlColumnEncryptionSettings