--exit-code, because drift is what this tool is for finding, and finding it is not a failure.",
+ "exit.differences": "A comparison ran and found the configuration drifted - an entry added or removed, or one set up differently. Running state alone is not drift. Only with --exit-code, because drift is what this tool is for finding, and finding it is not a failure.",
"switch.query": "Narrow the listing with the query language.",
"switch.signatures": "Read who signed each binary and whether Windows trusts it. Several seconds over a whole machine, so it is off unless asked - and a query about signatures turns it on by itself.",
@@ -52,7 +52,7 @@
"switch.components": "On license, turn the notice into every component inside this executable with its version, its licence and where it came from. The same set the bill of materials published beside the download carries, because both are rendered from one register.",
"switch.json": "The same document, machine readable, on standard output.",
"switch.note": "What the snapshot was taken for, kept inside the file.",
- "switch.exit-code": "End with code 5 when anything differs. Off by default, so a script that only wants the differences printed is not tripped by finding some.",
+ "switch.exit-code": "End with code 5 when the configuration differs - an entry added or removed, or one set up differently. Running state alone does not count. Off by default, so a script that only wants the differences printed is not tripped by finding some.",
"switch.live": "Compare the file against this machine as it is now, rather than against a second file.",
"switch.timing": "How long each part of the read took, on standard error.",
"switch.dry-run": "Print the plan and change nothing. It is the same plan an execution runs - there is no second code path for the real thing.",
diff --git a/site/i18n/pl.json b/site/i18n/pl.json
index 2a06643..df73e40 100644
--- a/site/i18n/pl.json
+++ b/site/i18n/pl.json
@@ -38,7 +38,7 @@
"exit.usage": "Wiersz poleceń był zły. Przy literówce w komendzie program podpowiada tę, o którą prawdopodobnie chodziło.",
"exit.incomplete": "Plan był dobry, wykonał się, a coś w nim nie dotarło tam, gdzie miało - menedżer odmówił albo sesja nie miała do tego praw.",
"exit.interrupted": "Ktoś zatrzymał przebieg ręcznie. Niezerowy nawet wtedy, gdy każdy krok i tak dotarł, żeby skrypt nadrzędny nie potraktował przerwanego przebiegu jako czystego.",
- "exit.differences": "Porównanie wykonało się i znalazło różnice. Tylko z --exit-code, bo dryf jest tym, czego to narzędzie szuka, a znalezienie go nie jest porażką.",
+ "exit.differences": "Porównanie wykonało się i znalazło dryf konfiguracji - wpis doszedł albo zniknął, albo jest ustawiony inaczej. Sam stan pracy nie jest dryfem. Tylko z --exit-code, bo dryf jest tym, czego to narzędzie szuka, a znalezienie go nie jest porażką.",
"switch.query": "Zawęża listę językiem zapytań.",
"switch.signatures": "Czyta, kto podpisał każdy plik i czy Windows temu podpisowi ufa. Kilka sekund na całej maszynie, więc jest wyłączone, dopóki nie poprosisz - a zapytanie o podpisy włącza to samo.",
@@ -52,7 +52,7 @@
"switch.components": "Przy license zamienia notę w pełną listę: każdy składnik wewnątrz tego pliku wykonywalnego, z wersją, licencją i adresem źródeł. Ten sam zestaw, który niesie spis składników publikowany obok pobrania, bo oba powstają z jednego rejestru.",
"switch.json": "Ten sam dokument, czytelny dla maszyny, na wyjściu standardowym.",
"switch.note": "Po co snapshot został zrobiony - zapisane w środku pliku.",
- "switch.exit-code": "Kończy kodem 5, gdy cokolwiek się różni. Domyślnie wyłączone, żeby skrypt, który chce tylko zobaczyć różnice, nie wywracał się na tym, że je znalazł.",
+ "switch.exit-code": "Kończy kodem 5, gdy różni się konfiguracja - wpis doszedł albo zniknął, albo jest ustawiony inaczej. Sam stan pracy się nie liczy. Domyślnie wyłączone, żeby skrypt, który chce tylko zobaczyć różnice, nie wywracał się na tym, że je znalazł.",
"switch.live": "Porównuje plik z tą maszyną w jej obecnym stanie, zamiast z drugim plikiem.",
"switch.timing": "Ile trwała każda część odczytu, na wyjściu błędów.",
"switch.dry-run": "Drukuje plan i nie zmienia niczego. To ten sam plan, który wykonuje się przy wykonaniu - nie ma drugiej ścieżki kodu dla wersji prawdziwej.",
diff --git a/site/pages/audit-windows-services/en.html b/site/pages/audit-windows-services/en.html
index 9740345..aa7e6f2 100644
--- a/site/pages/audit-windows-services/en.html
+++ b/site/pages/audit-windows-services/en.html
@@ -41,8 +41,8 @@ Exit code 5 is what makes this an audit rather than a report nobody reads: the task is silent until the machine drifts, and the night it does, somebody is paged.
Take the baseline from an elevated session. Without administrator rights the manager lists fewer entries and refuses more of what it lists. The snapshot records whether the account that took it was an administrator, so the comparison can say that rather than reporting entries as removed that nobody removed - but a baseline missing half the machine is still a baseline missing half the machine.
diff --git a/site/pages/audit-windows-services/pl.html b/site/pages/audit-windows-services/pl.html index 1dd9798..19622e6 100644 --- a/site/pages/audit-windows-services/pl.html +++ b/site/pages/audit-windows-services/pl.html @@ -41,8 +41,8 @@Kod wyjścia 5 jest tym, co robi z tego audyt, a nie raport, którego nikt nie czyta: zadanie milczy, dopóki maszyna się nie rozjedzie, a tej nocy, w której się rozjedzie, ktoś zostaje wezwany.
Punkt odniesienia rób z sesji elewowanej. Bez praw administratora menedżer wymienia mniej wpisów i odmawia częściej. Snapshot zapisuje, czy konto, które go zrobiło, było administratorem, więc porównanie może to powiedzieć, zamiast zgłaszać jako usunięte wpisy, których nikt nie usunął - ale punkt odniesienia bez połowy maszyny nadal jest punktem odniesienia bez połowy maszyny.
diff --git a/site/pages/cli-reference/en.html b/site/pages/cli-reference/en.html index a786747..97ec479 100644 --- a/site/pages/cli-reference/en.html +++ b/site/pages/cli-reference/en.html @@ -97,8 +97,8 @@The window is the other half of the same engine: {{archive_window}} holds it, and the download page says what each archive is.
Okno jest drugą połową tego samego silnika: niesie je {{archive_window}}, a strona pobierania mówi, co jest w którym archiwum.
--exit-code ends with 5 when anything differs, so a scheduled task can take a snapshot at deployment and page somebody the first night the machine drifts.--exit-code ends with 5 when the configuration differs, so a scheduled task can take a snapshot at deployment and page somebody the first night the machine drifts.--exit-code kończy kodem 5, gdy cokolwiek się różni - więc zadanie harmonogramu może zrobić snapshot przy wdrożeniu i wezwać kogoś pierwszej nocy, w której maszyna się rozjedzie.--exit-code kończy kodem 5, gdy różni się konfiguracja - więc zadanie harmonogramu może zrobić snapshot przy wdrożeniu i wezwać kogoś pierwszej nocy, w której maszyna się rozjedzie.--exit-code ends with 5 when anything differs. Not a failure - drift is what this tool is for finding, and finding it is not a failure - which is why it has a number of its own rather than borrowing the one that means something went wrong.
--exit-code ends with 5 when the configuration differs - an entry added or removed, or one set up differently. A service that only stopped or started by itself is reported and does not count, and neither do the per-user copies Windows makes for each signed-in session, which are left out and counted. Not a failure - drift is what this tool is for finding, and finding it is not a failure - which is why it has a number of its own rather than borrowing the one that means something went wrong.
# the day the machine goes into service
bws snapshot create C:\baselines\web01.json --note "after the build"
# every night, from a scheduled task
bws snapshot diff C:\baselines\web01.json --live --exit-code --json > C:\logs\drift.json
-# 0 - nothing differs
-# 5 - something differs, and drift.json says what
+# 0 - no configuration drift
+# 5 - the configuration drifted, and drift.json says what
# 3 - it ran and could not read everything, so the answer is partialThat is the whole mechanism: a baseline taken when the machine was known good, and a question asked every night. The first night it answers 5, somebody finds out on the first night rather than on the morning something breaks.
--exit-code kończy kodem 5, gdy cokolwiek się różni. To nie jest porażka - dryf jest tym, czego to narzędzie szuka, a znalezienie go nie jest porażką - i dlatego ma własny numer, zamiast pożyczać ten, który znaczy, że coś poszło źle.
--exit-code kończy kodem 5, gdy różni się konfiguracja - wpis doszedł albo zniknął, albo jest ustawiony inaczej. Usługa, która tylko sama się zatrzymała albo uruchomiła, jest w raporcie i się nie liczy, podobnie jak kopie per-użytkownik, które Windows robi dla każdej zalogowanej sesji - te są pomijane i policzone. To nie jest porażka - dryf jest tym, czego to narzędzie szuka, a znalezienie go nie jest porażką - i dlatego ma własny numer, zamiast pożyczać ten, który znaczy, że coś poszło źle.
# w dniu, w którym maszyna wchodzi do pracy
bws snapshot create C:\baselines\web01.json --note "after the build"
# co noc, z zadania harmonogramu
bws snapshot diff C:\baselines\web01.json --live --exit-code --json > C:\logs\drift.json
-# 0 - nic się nie różni
-# 5 - coś się różni, a drift.json mówi co
+# 0 - konfiguracja się nie rozjechała
+# 5 - konfiguracja się rozjechała, a drift.json mówi co
# 3 - wykonało się i nie wszystko dało się odczytać, więc odpowiedź jest częściowaTo cały mechanizm: punkt odniesienia wzięty, gdy maszyna była dobra, i pytanie zadawane co noc. Pierwszej nocy, w której odpowiedź brzmi 5, ktoś się o tym dowiaduje - zamiast rano tego dnia, w którym coś przestanie działać.