New-SqlColumnEncryptionSettings
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
Default (Par défaut)
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 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 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>.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.