New-SqlColumnEncryptionSettings

Módulo:: SqlServer

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

Sintaxe

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 do 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>.

Tipo:	String
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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.

Tipo:	String
Cargo:	2
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EncryptionType

Especifica o tipo de criptografia. Os valores aceitáveis para este 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.

Tipo:	String
Cargo:	1
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Saídas

SqlColumnEncryptionSettings

SQLServer_Cmdlets