New-SqlColumnEncryptionSettings

Référence

Module:: SQLServer

Crée un objet SqlColumnEncryptionSettings qui encapsule des informations sur le chiffrement d’une colonne unique, notamment le type de chiffrement et la clé de chiffrement de colonne.

Syntax

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

Description

L’applet de commande New-SqlColumnEncryptionSettings crée un objet SqlColumnEncryptionSettings . L’objet SqlColumnEncryptionSettings encapsule des informations sur les paramètres de Always Encrypted pour une seule colonne de base de données, notamment le type de chiffrement et la clé de chiffrement de colonne.

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

Exemples

Exemple 1 : Créer un objet SqlColumnEncryptionSettings chiffré pour une colonne

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

Cette commande crée un objet SqlColumnEncryptionSettings pour la colonne nommée dbo.Person.LastName, spécifiant le chiffrement déterministe et la clé de chiffrement de colonne nommée MyCEK pour la colonne. La commande stocke le résultat dans la variable nommée $EncryptionSettings.

Exemple 2 : Créer un objet SqlColumnEncryptionSettings non chiffré pour une colonne

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

Cette commande crée un objet SqlColumnEncryptionSettings pour la dbo.Person.FirstName colonne, en spécifiant que la colonne n’est pas chiffrée. La commande stocke le résultat dans la variable nommée $EncryptionSettings.

Paramètres

-ColumnName

Spécifie le nom de la colonne de base de données qui utilise le format suivant : [<schemaName>.]< tableName>.< columnName>.

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

-EncryptionKey

Spécifie le nom de l’objet clé de chiffrement de colonne. Cet argument n’est pas autorisé si la valeur du paramètre EncryptionType est définie sur Texte brut.

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

-EncryptionType

Spécifie le type de chiffrement. Les valeurs valides pour ce paramètre sont :

Déterministe, pour le chiffrement déterministe
Aléatoire, pour le chiffrement aléatoire
Texte en clair, indiquant que la colonne n’est pas chiffrée.

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

Sorties

SqlColumnEncryptionSettings

SQLServer_Cmdlets