Partager via

New-SqlColumnEncryptionSettings

  • Référence
Module:
SQLServer

Crée un objet SqlColumnEncryptionSettings qui encapsule des informations sur le chiffrement d’une seule colonne, y compris LEK et le type de chiffrement.

Syntaxe

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

Description

La cmdlet New-SqlColumnEncryptionSettings crée un objet SqlColumnEncryptionSettings. L’objet SqlColumnEncryptionSettings encapsule des informations sur les paramètres Always Encrypted pour une seule colonne de base de données, y compris 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, en 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 colonne dbo.Person.FirstName, 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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EncryptionType

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

  • 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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ProgressAction

Détermine comment PowerShell répond aux mises à jour de progression générées par un script, une applet de commande ou un fournisseur, telles que les barres de progression générées par l’applet de commande Write-Progress. L’applet de commande Write-Progress crée des barres de progression qui affichent l’état d’une commande.

Type:ActionPreference
Alias:proga
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

SqlColumnEncryptionSettings