New-SqlColumnEncryptionSettings

Referência

Módulo:: SQLServer

Cria um objeto SqlColumnEncryptionSettings que encapsula informações sobre a criptografia de uma única coluna, incluindo o tipo de criptografia e CEK.

Syntax

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

Description

O cmdlet New-SqlColumnEncryptionSettings cria um objeto SqlColumnEncryptionSettings . O objeto SqlColumnEncryptionSettings encapsula informações sobre as configurações de Always Encrypted para uma única coluna de banco de dados, incluindo o tipo de criptografia e a chave de criptografia de coluna.

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

Exemplos

Exemplo 1: criar um objeto SqlColumnEncryptionSettings criptografado para uma coluna

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

Esse comando cria um objeto SqlColumnEncryptionSettings para a coluna nomeada dbo.Person.LastName, especificando a criptografia determinística e a chave de criptografia de coluna nomeada MyCEK para a coluna. O comando armazena o resultado na variável chamada $EncryptionSettings.

Exemplo 2: criar um objeto SqlColumnEncryptionSettings não criptografado para uma coluna

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

Esse comando cria um objeto SqlColumnEncryptionSettings para a dbo.Person.FirstName coluna, especificando que a coluna não está criptografada. O comando armazena o resultado na variável chamada $EncryptionSettings.

Parâmetros

-ColumnName

Especifica o nome da coluna de banco de dados que usa o seguinte formato: [<schemaName>.]< tableName>.< columnName>.

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

-EncryptionKey

Especifica o nome do objeto de chave de criptografia de coluna. Esse argumento não será permitido se o valor do parâmetro EncryptionType for definido como Plaintext.

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

-EncryptionType

Especifica o tipo de criptografia. Os valores aceitáveis para esse parâmetro são:

Determinístico, para criptografia determinística
Randomizado, para criptografia aleatória
Texto sem formatação, indicando que a coluna não está criptografada.

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

Saídas

SqlColumnEncryptionSettings

SQLServer_Cmdlets