명령줄 참조

명령

명령은 열한 개입니다. snapshot은 명사라서 뒤에 단어가 옵니다. tool도 명사이며, 혼자 쓰면 도구 목록을 보여 줍니다.

bws list [--query TEXT] [--signatures] [--memory] [--required-by] [--follow-network] [--json] [--timing]
bws show NAME [--full] [--follow-network] [--json] [--timing]
bws stop|start|restart NAME [--dry-run] [--dependents] [--timeout SECONDS] [--json] [--timing]
bws kill NAME [--force] [--restart] [--dry-run] [--dependents] [--timeout SECONDS] [--json] [--timing]
bws start-type NAME automatic|delayed|manual|disabled [--stop] [--dry-run] [--json] [--timing]
bws snapshot create [FILE] [--note TEXT] [--follow-network] [--force] [--json] [--timing]
bws snapshot diff EARLIER LATER [--exit-code] [--json] [--timing]
bws snapshot diff EARLIER --live [--exit-code] [--json] [--timing]
bws history [NAME] [--json] [--timing]
bws tool
bws tool fix
bws tool fix NAME [--dry-run] [--timeout SECONDS] [--json] [--timing]
bws license [--components]
bws --help
bws --version

잘못 입력한 명령에는 의도했을 법한 명령이 제안되고, 요청한 것과 비슷한 일을 하는 대신 코드 2로 끝납니다.

$ bws lst
There is no command lst. Did you mean list?

각 명령이 하는 일

예

아래의 계획은 이 페이지가 설명하는 프로그램에 대해 --dry-run으로 확인했습니다. 무언가를 바꾸는 명령은 먼저 묻지 않으므로, 실행 전에 보려면 --dry-run을 쓰세요. Spooler는 아무 서비스를 대신하니, 그 자리에 사용 중인 서비스의 이름을 넣으세요.

bws list                                       이 컴퓨터의 모든 서비스와 드라이버
bws list --query "start:auto !status:running"  떠 있어야 하는데 떠 있지 않은 것
bws list --query "status:running" --memory     실행 중인 각 항목의 프로세스가 사용하는 것
bws show Spooler                               한 항목에 대해 알려진 모든 것
bws show Spooler --full                        정말로 비어 있는 필드도 함께

bws restart Spooler --dry-run                계획만, 그 밖에는 아무것도 없음
bws restart Spooler --dependents             종속된 것과 함께 재시작
bws stop Spooler --dependents --timeout 120  진행 없이 단계당 2분까지 허용
bws start-type WSearch delayed --dry-run     다른 자동 항목보다 조금 뒤에 시작
bws start-type Spooler disabled --stop       사용 안 함으로 바꾸고 한 계획으로 중지

bws kill Spooler --dry-run          프로세스와 그 안에 있는 모든 서비스
bws kill Spooler --restart          중지가 실패할 때만 프로세스를 종료하고, 그다음 모두 되돌림
bws kill Spooler --force --dry-run  두 단계 대신 한 단계: 프로세스를 바로 종료

bws snapshot create before.json --note "before the patch"  메모를 안에 담아 컴퓨터를 고정
bws snapshot diff before.json after.json                   파일 두 개, 이틀 또는 컴퓨터 두 대
bws snapshot diff before.json --live                       파일과 지금의 이 컴퓨터를 비교
bws snapshot diff before.json --live --exit-code           같은 비교이며, 구성이 드리프트했으면 5로 종료

bws history          System 로그에 있는 모든 시작 유형 변경과 설치
bws history Spooler  서비스 하나의 시작 유형 변경
bws history --json   같은 내용을 문서로, 로그와 변경 포함

bws tool                      있는 도구들
bws tool fix                  빠른 해결과 각각 뒤에 있는 서비스
bws tool fix sound --dry-run  오디오 서비스 두 개를 재시작하는 계획
bws tool fix printer          Print Spooler를 종속된 것과 함께 재시작

bws license --components  모든 구성 요소, 버전, 라이선스, 출처
bws --version             이 실행 파일의 버전

# 떠 있어야 하는데 떠 있지 않은 항목을 개체로
bws list --query "start:auto !status:running" --json | ConvertFrom-Json | Select-Object serviceName, displayName, status

# 서명 없는 파일을 스프레드시트로
bws list --query "signed:no" --json | ConvertFrom-Json | Select-Object serviceName, binaryPath | Export-Csv unsigned.csv -NoTypeInformation

# 서비스 하나가 필요로 하는 것
(bws show Spooler --json | ConvertFrom-Json).dependsOn

# 종료 코드로 분기하는 야간 점검
bws snapshot diff C:\baselines\web01.json --live --exit-code > $null
switch ($LASTEXITCODE) {
  0 { 'no configuration drift' }
  5 { 'the configuration drifted' }
  default { "no clean answer, exit code $LASTEXITCODE" }
}

rem 첫 번째 명령이 깨끗하게 끝나지 않았을 때만 두 번째 명령 실행
bws restart Spooler || echo the restart did not end cleanly

rem 지연된 확장을 켠 배치 파일에서는 !에 캐럿이 필요함
bws list --query "start:auto ^!status:running"

옵션

옵션은 18개입니다. 세 번째 열은 각 옵션이 속한 명령입니다. 쓸모가 없는 명령에 전달한 옵션은 조용히 무시되는 플래그가 아니라, 그 목록이 담긴 오류입니다.

종료 코드

끝나는 방식은 6가지이며, 각각은 스크립트가 해야 할 서로 다른 일입니다. 데이터는 표준 출력으로, 나머지는 모두 표준 오류로 나가므로 bws list --json | jq가 동작하고 경고가 JSON에 섞이지 않습니다.

모든 JSON 문서는 순수 ASCII입니다. ASCII 밖의 글자는 여섯 글자 이스케이프로 쓰이고 모든 JSON 판독기가 이를 글자로 되돌리므로, bws list --json > file.json은 유효한 UTF-8이고 | ConvertFrom-Json은 콘솔의 코드 페이지가 무엇이든 올바르게 읽습니다. 사람이 읽는 텍스트에서는, 출력되는 대신 터미널을 움직이게 할 글자(탭, 줄 바꿈, 이스케이프 시퀀스, 방향 재정의)가 코드 포인트 <U+001B>로 표시됩니다.

--는 옵션의 끝을 뜻하므로, 이름이 대시로 시작하는 서비스도 bws show -- -odd처럼 지정할 수 있습니다. 도구가 건네주는 명령줄은 PowerShell용으로 작성됩니다. 공백이 있는 이름은 큰따옴표에 넣으며 cmd도 같은 방식으로 읽고, MSSQL$SQLEXPRESS처럼 PowerShell이 큰따옴표 안에서 확장해 버릴 이름은 작은따옴표에 넣습니다.

Ctrl+C에는 세 단계가 있으며, 각각 다음 단계의 비용을 알려 줍니다. 첫 번째는 앞으로 나아가기를 멈추고 가져간 것을 되돌려 놓으며, 두 번째는 상태를 그대로 두고 보고서를 출력하며, 세 번째는 프로세스를 종료합니다. 수동으로 멈춘 실행은 모든 단계가 도달했더라도 4로 끝납니다.

콘솔 창을 닫는 것은 첫 번째 Ctrl+C로 간주됩니다. 그 뒤 Windows는 프로그램에 5초를 주며, 그동안 이 프로그램은 앞으로 나아가기를 멈추고 내려 둔 것을 되돌려 놓습니다. 로그아웃과 종료는 대응할 수 있는 경고 없이 프로그램을 끝내며, 끊어진 원격 세션도 그럴 수 있습니다.

예약 작업에서

이 도구가 만들어진 이유인 형태입니다. 컴퓨터가 정상이라고 알려져 있을 때 고정하고, 그 뒤 매일 밤 여전히 그런지 묻습니다.

# 컴퓨터가 운영에 들어가는 날
bws snapshot create C:\baselines\web01.json --note "after the build"

# 매일 밤, 예약 작업에서
bws snapshot diff C:\baselines\web01.json --live --exit-code --json > C:\logs\drift.json
#   0 - 구성 드리프트 없음
#   5 - 구성이 드리프트했으며, drift.json에 무엇인지 나옴
#   3 - 실행되었지만 모든 것을 읽지 못했으므로 답이 부분적임

창은 같은 엔진의 나머지 절반입니다. BetterWindowsServices-win-x64.zip에 들어 있으며, 각 압축 파일이 무엇인지는 다운로드 페이지에 있습니다.

창의 인수

BetterWindowsServices.exe는 사람을 위한 인수를 하나 받습니다. --catalogue는 창의 모든 구성 요소를 모든 상태로 보여 주는 개발자용 시트를 열며, 컴퓨터에서는 아무것도 읽지 않습니다. 두 번째인 --carry는 창이 보여 주던 것을, 관리자 권한으로 다시 시작하는 자신의 복사본에 넘기는 방법입니다. 아무도 직접 입력하지 않으며, 그 안에 그 창이 쓸 수 없었을 내용이 있으면 거부됩니다.