New-SqlColumnEncryptionSettings
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