레지스트리

  • 아티클

개요

레지스트리 키 또는 값을 관리합니다.

구문

Registry [String] #ResourceName
{
    Key = [string]
    ValueName = [string]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [Force = [bool]]
    [Hex = [bool]]
    [PsDscRunAsCredential = [PSCredential]]
    [ValueData = [string[]]]
    [ValueType = [string]{ Binary | DWord | ExpandString | MultiString | QWord | String }]
}

Description

리소스 Registry 를 사용하면 레지스트리 키를 추가 및 제거하고 레지스트리 키 값을 추가, 업데이트 및 제거할 수 있습니다.

요구 사항

없음

매개 변수

키 속성

키

레지스트리 키의 경로를 문자열로 지정합니다. 이 경로에는 레지스트리 하이브 또는 드라이브(예: HKEY_LOCAL_MACHINE 또는 HKLM:.)가 포함되어야 합니다.

Type: System.String
Behavior: Key

ValueName

레지스트리 값의 이름을 문자열로 지정합니다. 레지스트리 키를 추가하거나 제거하려면 ValueType 또는 ValueData 속성을 지정하지 않고 이 속성을 빈 문자열로 지정합니다. 레지스트리 키의 기본값을 업데이트하거나 제거하려면 ValueType 또는 ValueData 속성을 사용하여 이 속성을 빈 문자열로 지정합니다.

Type: System.String

선택적 속성

Ensure

레지스트리 키 또는 값이 있는지 여부를 지정합니다. 레지스트리 키 또는 값을 추가하거나 업데이트하려면 이 속성을 .로 Present설정합니다. 레지스트리 키 또는 값을 제거하려면 이 속성을 .로 Absent설정합니다.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

Force

레지스트리 키 값이 이미 있는 경우 레지스트리 키 값을 덮어쓸지 또는 하위 키가 있는 레지스트리 키를 삭제할지 여부를 지정합니다. 기본값은 $false입니다.

Type: System.Boolean
Default Value: false

Hex

지정된 레지스트리 키 데이터가 16진수 형식으로 제공되는지 여부를 지정합니다. ValueType이 DWord 있는 경우에만 이 속성을 지정합니다QWord. ValueType이 DWordQword아닌 경우 리소스는 이 속성을 무시합니다. 기본값은 $false입니다.

Type: System.Boolean
Default Value: false

ValueData

레지스트리 키 값을 문자열로 지정하거나 ValueType 이 MultiString면 문자열 배열을 지정합니다. ValueType이 아니 MultiString 고 이 속성의 값이 여러 문자열인 경우 리소스는 잘못된 인수 예외를 throw합니다.

Type: System.String[]
Default Value: None

ValueType

지정된 레지스트리 키 값의 데이터에 대한 형식을 지정합니다.

Type: System.String
Accepted Values:
  - Binary
  - DWord
  - ExpandString
  - MultiString
  - QWord
  - String
Default Value: String

예제