New-SqlColumnEncryptionSettings

Referenz

Modul:: SQLServer

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

SQLServer_Cmdlets