Tham chiếu dòng lệnh

Các lệnh

Mười một lệnh. snapshot là một danh từ và theo sau nó là một từ nữa. tool cũng là một danh từ, và đứng một mình nó liệt kê các công cụ.

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

Một lệnh gõ nhầm sẽ được đề nghị lệnh mà bạn có khả năng muốn dùng, và lần chạy kết thúc với mã 2 thay vì làm điều gì đó gần giống điều bạn yêu cầu.

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

Mỗi lệnh làm gì

Ví dụ

Các kế hoạch dưới đây đã được kiểm tra bằng --dry-run với chương trình mà trang này mô tả. Một lệnh thay đổi gì đó không hỏi trước, nên --dry-run là cách để xem trước khi nó chạy. Spooler đại diện cho bất kỳ dịch vụ nào - hãy đặt tên dịch vụ của bạn vào chỗ đó.

bws list                                       mọi dịch vụ và trình điều khiển trên máy này
bws list --query "start:auto !status:running"  những gì lẽ ra phải chạy mà không chạy
bws list --query "status:running" --memory     tiến trình của mỗi mục đang chạy đang dùng gì
bws show Spooler                               mọi thứ đã biết về một mục
bws show Spooler --full                        cả các trường thực sự trống

bws restart Spooler --dry-run                chỉ kế hoạch, không gì khác
bws restart Spooler --dependents             khởi động lại nó cùng những gì phụ thuộc vào nó
bws stop Spooler --dependents --timeout 120  cho phép hai phút mỗi bước không có tiến triển
bws start-type WSearch delayed --dry-run     khởi động muộn hơn một chút so với các mục tự động khác
bws start-type Spooler disabled --stop       vô hiệu hóa và dừng trong một kế hoạch

bws kill Spooler --dry-run          tiến trình, và mọi dịch vụ sống trong đó
bws kill Spooler --restart          chỉ kết thúc tiến trình nếu lệnh dừng thất bại, rồi đưa mọi thứ trở lại
bws kill Spooler --force --dry-run  một bước thay vì hai: tiến trình bị kết thúc ngay

bws snapshot create before.json --note "before the patch"  đóng băng máy, kèm một ghi chú lưu bên trong
bws snapshot diff before.json after.json                   hai tệp - hai ngày, hoặc hai máy
bws snapshot diff before.json --live                       tệp so với máy này như hiện giờ
bws snapshot diff before.json --live --exit-code           như trên, kết thúc bằng 5 nếu cấu hình đã lệch

bws history          mọi lần đổi kiểu khởi động và cài đặt mà nhật ký System lưu
bws history Spooler  các lần đổi kiểu khởi động của một dịch vụ
bws history --json   như trên dưới dạng tài liệu, kèm nhật ký và thay đổi

bws tool                      các công cụ hiện có
bws tool fix                  các cách sửa nhanh, và dịch vụ đằng sau mỗi cách
bws tool fix sound --dry-run  kế hoạch khởi động lại hai dịch vụ âm thanh
bws tool fix printer          khởi động lại Print Spooler cùng những gì phụ thuộc vào nó

bws license --components  mọi thành phần, phiên bản, giấy phép và nguồn gốc của nó
bws --version             phiên bản của tệp thực thi này

# các mục lẽ ra phải chạy mà không chạy, dưới dạng đối tượng
bws list --query "start:auto !status:running" --json | ConvertFrom-Json | Select-Object serviceName, displayName, status

# các tệp chưa ký, vào một bảng tính
bws list --query "signed:no" --json | ConvertFrom-Json | Select-Object serviceName, binaryPath | Export-Csv unsigned.csv -NoTypeInformation

# một dịch vụ cần gì
(bws show Spooler --json | ConvertFrom-Json).dependsOn

# một lần kiểm tra hằng đêm rẽ nhánh theo mã thoát
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 lệnh thứ hai chỉ khi lệnh đầu không kết thúc sạch
bws restart Spooler || echo the restart did not end cleanly

rem trong tệp batch bật delayed expansion, dấu ! cần dấu ^
bws list --query "start:auto ^!status:running"

Tùy chọn

18 tùy chọn. Cột thứ ba là các lệnh mà mỗi tùy chọn thuộc về - một tùy chọn truyền cho lệnh không dùng đến nó là một lỗi có danh sách đó trong đó, chứ không phải một cờ bị lặng lẽ bỏ qua.

Mã thoát

6 kết cục, và mỗi kết cục là một việc khác nhau để script làm. Dữ liệu đi tới đầu ra chuẩn và mọi thứ khác đi tới lỗi chuẩn, nên bws list --json | jq hoạt động và một cảnh báo không bao giờ rơi vào JSON của bạn.

Mọi tài liệu JSON là ASCII thuần: một chữ cái ngoài ASCII được viết thành một chuỗi thoát sáu ký tự mà mọi trình đọc JSON biến trở lại thành chữ cái, nên bws list --json > file.json là UTF-8 hợp lệ và | ConvertFrom-Json đọc đúng bất kể bảng mã của bảng điều khiển. Trong văn bản mà con người đọc, một ký tự sẽ di chuyển thiết bị đầu cuối thay vì in ra - một tab, một ngắt dòng, một chuỗi thoát, một ký tự ghi đè hướng - được hiển thị dưới dạng điểm mã của nó, <U+001B>.

-- kết thúc các tùy chọn, nên một dịch vụ có tên bắt đầu bằng dấu gạch ngang vẫn có thể được nêu tên: bws show -- -odd. Các dòng lệnh mà công cụ đưa cho bạn được viết cho PowerShell: một tên có dấu cách đặt trong nháy kép, cmd đọc giống vậy, và một tên mà PowerShell sẽ mở rộng bên trong chúng, như MSSQL$SQLEXPRESS, đặt trong nháy đơn.

Ctrl+C có ba mức, mỗi mức nói mức tiếp theo tốn gì. Mức đầu ngừng tiến tới và vẫn trả lại những gì đã lấy, mức hai để mọi thứ như hiện trạng và vẫn in báo cáo, mức ba kết thúc tiến trình. Một lần chạy bị dừng bằng tay kết thúc với 4 ngay cả khi mọi bước vẫn đã đến nơi.

Đóng cửa sổ console được tính là Ctrl+C đầu tiên. Windows cho một chương trình năm giây sau đó, và trong thời gian ấy nó ngừng tiến tới và trả lại những gì nó đã hạ gục. Đăng xuất và tắt máy kết thúc nó mà không có cảnh báo nào để nó hành động, và một phiên từ xa bị rớt có thể cũng vậy.

Trong một tác vụ theo lịch

Dạng mà công cụ này được xây dựng cho: đóng băng máy khi biết nó tốt, rồi mỗi đêm hỏi xem nó có còn như vậy không.

# ngày máy bắt đầu đưa vào hoạt động
bws snapshot create C:\baselines\web01.json --note "after the build"

# mỗi đêm, từ một tác vụ theo lịch
bws snapshot diff C:\baselines\web01.json --live --exit-code --json > C:\logs\drift.json
#   0 - không có sai lệch cấu hình
#   5 - cấu hình đã lệch, và drift.json nói là gì
#   3 - đã chạy và không đọc được hết, nên câu trả lời chỉ là một phần

Cửa sổ là nửa còn lại của cùng lõi: BetterWindowsServices-win-x64.zip chứa nó, và trang tải xuống nói mỗi bản nén là gì.

Đối số của cửa sổ

BetterWindowsServices.exe nhận một đối số dành cho con người: --catalogue mở một tờ dành cho nhà phát triển hiển thị mọi thành phần của cửa sổ ở mọi trạng thái, và không đọc gì từ máy của bạn. Đối số thứ hai, --carry, là cách một cửa sổ chuyển những gì nó đang hiển thị cho bản sao của chính nó mà nó khởi động lại với quyền quản trị. Không ai gõ nó, và bất cứ thứ gì trong đó mà cửa sổ đó không thể đã viết ra đều bị từ chối.