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