New-SqlColumnEncryptionSettings
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
Default (impostazione predefinita).
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 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 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 utilizza il formato seguente: [<schemaName>.]<tableName>.<columnName>.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 2 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.