New-SqlColumnEncryptionSettings
Cria um objeto SqlColumnEncryptionSettings que encapsula informações sobre a criptografia de uma única coluna, incluindo CEK e tipo de criptografia.
Sintaxe
Default (Padrão)
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>.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.