dsc

아티클
03/06/2024

개요

구성을 적용하거나 특정 리소스를 호출하여 소프트웨어 구성 요소를 관리합니다.

구문

dsc [Options] <COMMAND>

명령

completer

명령은 completer 실행될 때 지정된 셸에 대한 완료를 등록하는 셸 스크립트를 반환합니다. 자세한 내용은 completer를 참조하세요.

config

명령은 config DSC 구성 문서를 관리합니다. 이를 사용하여 다음을 할 수 있습니다.

구성의 현재 상태를 가져옵니다.
구성이 원하는 상태인지 테스트합니다.
구성을 원하는 상태로 설정합니다.

자세한 내용은 구성을 참조 하세요.

resource

명령은 resource DSC 리소스를 관리합니다. 이를 사용하여 다음을 할 수 있습니다.

사용 가능한 리소스를 나열합니다.
리소스 인스턴스에 대한 JSON 스키마를 가져옵니다.
리소스 instance 현재 상태를 가져옵니다.
리소스 instance 원하는 상태인지 테스트합니다.
리소스 instance 원하는 상태로 설정합니다.

자세한 내용은 리소스를 참조하세요.

스키마

명령은 schema 특정 DSC 형식에 대한 JSON 스키마를 반환합니다. 자세한 내용은 스키마를 참조하세요.

help

명령은 help dsc, 명령 또는 하위 명령에 대한 도움말 정보를 반환합니다.

명령 또는 하위 명령에 대한 도움말을 보려면 다음 구문을 사용합니다.

dsc help <COMMAND> [<SUBCOMMAND>]

예를 들어 는 dsc help config 하위 명령에 대한 도움말을 config 가져옵니다. dsc help config set 는 하위 명령에 대한 도움말을 config set 가져옵니다.

명령에서 --help 옵션을 사용하여 도움말 정보를 표시할 수도 있습니다. 예를 들어 dsc config --help 또는 dsc config set --help입니다.

옵션

-h, --help

현재 명령 또는 하위 명령에 대한 도움말을 표시합니다. 이 옵션을 지정하면 애플리케이션은 이 옵션 다음에 있는 모든 옵션과 인수를 무시합니다.

Type:      Boolean
Mandatory: false

-l, --trace-level

작업 중에 내보내야 하는 최소 메시지 수준 DSC를 정의합니다. DSC의 메시지는 해당 수준으로 분류됩니다.

다음 목록에서는 가장 높은 수준부터 가장 낮은 수준까지의 유효한 메시지 수준을 보여줍니다. 이 옵션을 목록의 모든 값으로 설정하면 DSC는 해당 수준 이상에서 메시지를 내보낸다.

error
warning(기본값)
info
debug
trace

경고

수준 출력은 trace DSC가 실행하는 동안 처리하는 모든 JSON 입력/출력을 내보냅니다. DSC는 JSON을 내보내기 전에 삭제하지 않습니다. 이 추적 수준은 개발자 전용입니다. 중요한 정보가 포함될 수 있으므로 수준 출력을 스토리지로 리디렉션 trace 하지 마세요.

예를 들어 로그 수준이 인 경우 DSC는 debug를 제외한 trace모든 로그 수준에 대한 메시지를 내보낸다. 로그 수준이 이면 DSC는 error오류 메시지만 내보낸다. DSC는 로그 수준이 낮은 모든 메시지를 무시합니다.

Type:         String
Mandatory:    false
DefaultValue: warning
ValidValues:  [error, warning, info, debug, trace]

-f, --trace-format

stderr에서 추적 메시지를 내보낸 경우 사용할 출력 형식을 정의합니다. DSC는 다음 형식을 지원합니다.

default - 타임스탬프, 메시지 수준 및 줄 번호에 대한 ANSI 콘솔 색 지정을 사용하여 메시지를 내보낸다.
plaintext - 콘솔 default 색은 제외됩니다.
json - 타임스탬프, 수준, 메시지 및 줄 번호를 속성으로 사용하여 각 메시지를 압축된 JSON 개체로 내보냅니다.

Type:         String
Mandatory:    false
DefaultValue: default
ValidValues:  [default, plaintext, json]

-V, --version

애플리케이션의 버전을 표시합니다. 이 옵션을 지정하면 애플리케이션은 이 옵션 다음에 있는 모든 옵션과 인수를 무시합니다.

Type:      Boolean
Mandatory: false

환경 변수

기본적으로 dsc 명령은 환경 변수에 의해 정의된 폴더에서 명령 기반 DSC 리소스 매니페스트를 PATH 검색합니다. 환경 변수가 DSC_RESOURCE_PATH 정의된 경우 대신 폴더를 검색합니다 DSC_RESOURCE_PATHPATH. dsc

환경은 DSC_RESOURCE_PATH 운영 체제의 환경 변수와 PATH 동일한 규칙을 따르는 환경 변수여야 합니다. Windows의 세미콜론()과 다른 플랫폼의 콜론(;:)을 사용하여 폴더 경로를 구분합니다.

종료 코드

명령은 dsc 의미 체계 종료 코드를 사용합니다. 각 종료 코드는 명령 실행에 대한 다른 결과를 나타냅니다.

종료 코드	의미
`0`	명령이 오류 없이 성공적으로 실행되었습니다.
`1`	명령이 잘못된 인수를 받았기 때문에 실패했습니다.
`2`	리소스에서 오류가 발생했기 때문에 명령이 실패했습니다.
`3`	값을 JSON으로 직렬화하거나 역직렬화할 수 없기 때문에 명령이 실패했습니다.
`4`	명령에 대한 입력이 유효한 YAML 또는 JSON이 아니므로 명령이 실패했습니다.
`5`	리소스 정의 또는 instance 값이 JSON 스키마에 대해 유효하지 않아 명령이 실패했습니다.
`6`	`Ctrl`+`C` 중단으로 명령이 취소되었습니다.

dsc

개요

구문

명령