New-SqlColumnEncryptionSettings
Erstellt ein SqlColumnEncryptionSettings-Objekt, das Informationen über die Verschlüsselung einer einzelnen Spalte kapselt, einschließlich Spaltenverschlüsselungsschlüssel und Verschlüsselungstyp.
Syntax
New-SqlColumnEncryptionSettings
[-ColumnName] <String>
[-EncryptionType] <String>
[[-EncryptionKey] <String>]
[<CommonParameters>]
Beschreibung
Das Cmdlet New-SqlColumnEncryptionSettings erstellt ein SqlColumnEncryptionSettings-Objekt . Das SqlColumnEncryptionSettings-Objekt kapselt Informationen zu den Always Encrypted Einstellungen für eine einzelne Datenbankspalte, einschließlich des Verschlüsselungstyps und des Spaltenverschlüsselungsschlüssels.
Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.
Beispiele
Beispiel 1: Erstellen eines verschlüsselten SqlColumnEncryptionSettings-Objekts für eine Spalte
PS C:\> $EncryptionSettings = New-SqlColumnEncryptionSettings dbo.Person.LastName "Deterministic" MyCEK
Dieser Befehl erstellt ein SqlColumnEncryptionSettings -Objekt für die Spalte namens dbo.Person.LastName
, die den deterministischen Verschlüsselungs- und Spaltenverschlüsselungsschlüssel MyCEK
für die Spalte angibt.
Der Befehl speichert das Ergebnis in der Variablen namens $EncryptionSettings
.
Beispiel 2: Erstellen eines unverschlüsselten SqlColumnEncryptionSettings-Objekts für eine Spalte
PS C:\> $EncryptionSettings = New-SqlColumnEncryptionSettings dbo.Person.FirstName "Plaintext"
Mit diesem Befehl wird ein SqlColumnEncryptionSettings-Objekt für die dbo.Person.FirstName
Spalte erstellt, das angibt, dass die Spalte nicht verschlüsselt ist. Der Befehl speichert das Ergebnis in der Variablen namens $EncryptionSettings
.
Parameter
-ColumnName
Gibt den Namen der Datenbankspalte an, die das folgende Format verwendet: [<schemaName>.]< tableName>.< columnName>.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EncryptionKey
Gibt den Namen des Spaltenverschlüsselungsschlüsselobjekts an. Dieses Argument ist nicht zulässig, wenn der Parameterwert "EncryptionType" auf "Plaintext" festgelegt ist.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EncryptionType
Gibt den Typ der Verschlüsselung an. Zulässige Werte für diesen Parameter:
- Deterministisch, für deterministische Verschlüsselung
- Zufällig, für zufällige Verschlüsselung
- Nurtext, der angibt, dass die Spalte nicht verschlüsselt ist.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Ausgaben
SqlColumnEncryptionSettings