다음을 통해 공유


New-SqlColumnEncryptionSettings

CEK 및 암호화 형식을 포함하여 단일 열의 암호화에 대한 정보를 캡슐화하는 SqlColumnEncryptionSettings 개체를 만듭니다.

구문

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

Description

New-SqlColumnEncryptionSettings cmdlet은 SqlColumnEncryptionSettings 개체를 만듭니다. SqlColumnEncryptionSettings 개체는 암호화 유형 및 열 암호화 키를 포함하여 단일 데이터베이스 열에 대한 Always Encrypted 설정에 대한 정보를 캡슐화합니다.

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

예제

예제 1: 열에 대해 암호화된 SqlColumnEncryptionSettings 개체 만들기

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

이 명령은 dbo.Person.LastName열에 대한 SqlColumnEncryptionSettings 개체를 만들고, 열에 대한 MyCEK 명명된 결정적 암호화 및 열 암호화 키를 지정합니다. 이 명령은 결과를 $EncryptionSettings변수에 저장합니다.

예제 2: 열에 대해 암호화되지 않은 SqlColumnEncryptionSettings 개체 만들기

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

이 명령은 dbo.Person.FirstName 열에 대한 SqlColumnEncryptionSettings 개체를 만들고 열이 암호화되지 않도록 지정합니다. 이 명령은 결과를 $EncryptionSettings변수에 저장합니다.

매개 변수

-ColumnName

[<schemaName>.]<tableName>형식을 사용하는 데이터베이스 열의 이름을 지정합니다. columnName><.

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-EncryptionKey

열 암호화 키 개체의 이름을 지정합니다. EncryptionType 매개 변수 값이 Plaintext로 설정된 경우에는 이 인수를 사용할 수 없습니다.

형식:String
Position:2
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-EncryptionType

암호화 유형을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 결정적 암호화를 위한 결정적
  • 임의 암호화의 경우 임의로
  • 열이 암호화되지 않았음을 나타내는 일반 텍스트입니다.
형식:String
Position:1
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ProgressAction

powerShell이 스크립트, cmdlet 또는 공급자(예: Write-Progress cmdlet에서 생성된 진행률 표시줄)에 의해 생성된 진행률 업데이트에 응답하는 방법을 결정합니다. Write-Progress cmdlet은 명령의 상태를 표시하는 진행률 표시줄을 만듭니다.

형식:ActionPreference
별칭:proga
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

출력

SqlColumnEncryptionSettings