New-SqlColumnEncryptionSettings

Riferimento

Modulo:: SQLServer

Crea un oggetto SqlColumnEncryptionSettings che incapsula le informazioni sulla crittografia di una singola colonna, tra cui la chiave di crittografia della colonna e il tipo di crittografia.

Sintassi

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

Descrizione

Il cmdlet New-SqlColumnEncryptionSettings crea un oggetto SqlColumnEncryptionSettings . L'oggetto SqlColumnEncryptionSettings incapsula informazioni sulle impostazioni di Always Encrypted per una singola colonna di database, incluso 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 , specificando la crittografia deterministica e la chiave di crittografia delle colonne denominata dbo.Person.LastNameMyCEK 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 dbo.Person.FirstName colonna, 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 usa il formato seguente: [<schemaName>.]< tableName>.< columnName>.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 normale.

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

-EncryptionType

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

Deterministico, per la crittografia deterministica
Casuale, per la crittografia casuale
Testo non crittografato, che indica che la colonna non è crittografata.

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

Output

SqlColumnEncryptionSettings

SQLServer_Cmdlets