Compartilhar via

New-SqlColumnEncryptionSettings

  • Referência
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>]
   [-ProgressAction <ActionPreference>]
   [<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 chamada , especificando a criptografia determinística e a chave de criptografia de coluna chamada 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 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

-ProgressAction

Determina como o PowerShell responde às atualizações de progresso geradas por um script, cmdlet ou provedor, como as barras de progresso geradas pelo cmdlet Write-Progress. O cmdlet Write-Progress cria barras de progresso que mostram o status de um comando.

Tipo:ActionPreference
Aliases:proga
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

SqlColumnEncryptionSettings