Praktyczne zastosowanie w środowisku domenowym (zbieranie i konwersja sterowana przez GPO)

For AI agents: a documentation index is available at /llms.txt; a markdown version of this page is available at /v1.2.0.0/pl/docs/examples/gpo-driven-collection/index.md.

Ten dokument przedstawia praktyczny, kompleksowy przykład uruchomienia DNSServer.DebugLogParser w środowisku domeny Active Directory, skupiając się na konwersji dzienników debugowania serwera DNS Windows na kontrolerach domeny.

Do tego przykładu dołączony jest archiwum ZIP, które zawiera artefakty polityki używane do wdrożenia opisanego tutaj przepływu pracy.
Najważniejsze artefakty to manifest kopii zapasowej, raport GPO, Files.xml, Set-DNSServerDebugLogging.ps1 oraz ScheduledTasks.xml.

Scenariusz

• Kilka kontrolerów domeny (DC) pełni rolę serwera DNS.
• Debugowanie DNS jest włączone i spójnie skonfigurowane na każdym DC za pomocą zadania zaplanowanego (zapisujące pliki dziennika do C:\Administration\Logs\DNSServer).
• Centralnie zarządzany proces konwertuje dzienniki na CSV do celów:
  • analizy bezpieczeństwa
  • raportowania operacyjnego
  • rozwiązywania problemów
  • zgodności/przechowywania danych

Docelowe rezultaty

• Spójne ustawienia konwersji na wszystkich DC
• Przewidywalna lokalizacja i nazewnictwo plików wyjściowych
• Opcjonalna kompresja zmniejszająca zajętość miejsca
• Opcjonalne statystyki do szybkich podsumowań dziennych
• Minimalne ryzyko po stronie hosta, z wyraźnymi zasadami ponownego uruchomienia i czyszczenia

Proponowana architektura

Model zbierania: lokalna konwersja + centralne pobieranie

1. Każdy DC zapisuje dzienniki debugowania DNS na dysku z włączonym przełączaniem plików.
2. Każdy DC konwertuje obrócone pliki *.log na dane CSV i statystyki CSV, a następnie kompresuje wyniki do *.zip według harmonogramu (Harmonogram zadań).
3. Wyniki są zapisywane obok plików dziennika, aby uprościć potok.
4. Centralny serwer zbiera pliki *.zip, na przykład przez udostępnianie plików, zaplanowane kopiowanie, przekazywanie do SIEM lub kolektor oparty na agencie.

Ten model minimalizuje odczyty sieciowe dużych surowych plików dziennika i utrzymuje analizę blisko danych.

Przepływ pracy GPO

Przepływ pracy jest realizowany przez Politykę Grupową (konfiguracja komputera), aby zapewnić spójne ustawienia na wszystkich kontrolerach domeny.

Referencyjna implementacja zawarta w tym repozytorium (raport GPO):

• Nazwa archiwum/raportu: T0-C-Analytics-DNSDebugLogging
• ID kopii zapasowej: {2B6F16BC-0E7C-4787-83D7-2854FED882EE}
• Cel linku GPO: corp.company.com/Domain Controllers
• Filtr elementów (używany zarówno do wdrożenia plików, jak i zadań zaplanowanych): stosowany tylko jeśli istnieje C:\Windows\System32\dns.exe

1) Wymagania wstępne (foldery + moduł)

Dostarczona kopia zapasowa zakłada, że te foldery już istnieją. Dodaj osobne elementy GPP, jeśli chcesz, aby wdrożenie tworzyło je automatycznie:

• C:\Administration\Scripts
• C:\Administration\Logs\DNSServer

Kopia zapasowa zakłada również, że Convert-DNSDebugLogFile jest już dostępny na DC. Zadanie konwersji uruchamia Windows PowerShell 5.1 z -NoProfile i nie importuje modułu jawnie, więc moduł musi być zainstalowany w ścieżce modułów Windows PowerShell widocznej dla LocalSystem. Zalecane podejścia:

• Zainstaluj DNSServer.DebugLogParser na DC, np. z PowerShell Gallery (jeśli polityka na to pozwala).
• Wdróż moduł przez wewnętrzne repozytorium / udział plików, aby był wykrywalny w $env:PSModulePath
• Dodaj jawny Import-Module do akcji zadania, jeśli chcesz mieć deterministyczne ładowanie

2) Wdrożenie skryptu konfigurującego debugowanie DNS (GPP Files)

GPO wdraża skrypt:

• Źródło (w SYSVOL przez GPP): %GptPath%\Preferences\Files\Set-DNSServerDebugLogging.ps1
• Cel (na każdym DC): C:\Administration\Scripts\Set-DNSServerDebugLogging.ps1

Jest to zaimplementowane w elemencie preferencji GPP Files w Files.xml.

3) Zadanie zaplanowane: konfiguracja debugowania DNS

GPO tworzy zadanie zaplanowane o nazwie Set-DNSServerDebugLogging.

• Kontekst bezpieczeństwa w dostarczonej kopii zapasowej: SYSTEM z typem logowania S4U
• Wyzwalacz w dostarczonej kopii zapasowej: codziennie (start 2025-03-01T00:00:01)
• Akcja w ScheduledTasks.xml:
  • powershell.exe -ExecutionPolicy RemoteSigned -command " & { C:\Administration\Scripts\Set-DNSServerDebugLogging.ps1 }"
  • Katalog roboczy: C:\Administration\Scripts

Powiązany skrypt Set-DNSServerDebugLogging.ps1 konfiguruje debugowanie DNS za pomocą Get-DnsServerDiagnostics / Set-DnsServerDiagnostics i (co ważne):

• Włącza logowanie do pliku + przełączanie plików
• Zapisuje do: C:\Administration\Logs\DNSServer\DnsDebugLog_<COMPUTERNAME>.<Domain>_.log
• Ustawia rozmiar przełączania na 10 MB na plik
• Rejestruje głównie aktywność związaną z zapytaniami (zapytania + powiadomienia + aktualizacje + transakcje zapytań) i wyklucza pełne logowanie pakietów

4) Zadanie zaplanowane: konwersja obróconych dzienników debugowania do skompresowanego CSV

GPO tworzy zadanie zaplanowane o nazwie Convert-DNSDebugLogs.

• Kontekst bezpieczeństwa w dostarczonej kopii zapasowej: SYSTEM z typem logowania InteractiveToken
• Wyzwalacz w dostarczonej kopii zapasowej: codziennie (start 2026-01-01T00:30:00)
• Katalog roboczy: C:\Administration\Logs\DNSServer
• Akcja w ScheduledTasks.xml (formatowana dla czytelności):

Get-ChildItem .\*.log |
  Sort-Object lastwritetime, Name -Descending |
  Select-Object -Skip 1 |
  Convert-DNSDebugLogFile `
    -ComputerName $env:COMPUTERNAME `
    -Delimiter ';' `
    -OutputType Both `
    -ContextFilter Packet `
    -OutputCulture sv-SE `
    -CompressOutput

Uwagi projektowe:

• Select-Object -Skip 1 celowo pomija najnowszy (aktywny) plik dziennika.
• Oznacza to, że bieżące dane są eksportowane dopiero po przełączeniu; na DC o niskim natężeniu ruchu aktywny dziennik może pozostać nieprzetworzony przez ponad dzień.
• Ponieważ Convert-DNSDebugLogFile domyślnie ustawia -OutputFile na „ten sam folder, ta sama nazwa, .csv”, wyniki trafiają obok plików *.log.
• Z -CompressOutput każdy przetworzony dziennik generuje *.zip, a pośrednie CSV są usuwane.
• Jeśli nie archiwizujesz ani nie usuwasz przetworzonych plików *.log, kolejne uruchomienia będą ponownie przetwarzać każdy nieaktywny dziennik.
• Zadanie zgłasza błąd, jeśli $Error.Count -gt 0, sygnalizując nieudane uruchomienie.

5) Centralne pobieranie

Opcje (wybierz jedną):

• Pobieranie przez udział plików: DC zapisuje (lub kopiuje) C:\Administration\Logs\DNSServer\*.zip do \\fileserver\share\dns\$env:COMPUTERNAME\... (przyznaj prawa do udziału i NTFS kontom komputerów DC lub grupie Domain Controllers, jeśli zadanie działa jako SYSTEM)
• Model pull: centralne zadanie odczytuje \\dc\C$\Administration\Logs\DNSServer\*.zip (najmniej preferowane; wymaga udziałów administracyjnych)
• Agent forwarder: SIEM / potok logów przesyłający pliki *.zip

Rozważania operacyjne

• Zasada najmniejszych uprawnień: zadania działają jako SYSTEM; upewnij się, że lokalne foldery są zapisywalne i że dowolne cele UNC przyznają dostęp kontu komputera, jeśli są używane.
• Polityka podpisywania: oba zadania używają -ExecutionPolicy RemoteSigned; podpisz lub odblokuj wdrożony skrypt i moduł zgodnie z polityką.
• Wykorzystanie dysku: -CompressOutput znacząco pomaga, ale ten przepływ pracy nie usuwa źródłowych dzienników; zaplanuj retencję i czyszczenie.
• Zachowanie ponownego przetwarzania: jeśli nie archiwizujesz ani nie usuwasz przetworzonych dzienników, zadanie konwersji będzie ponownie przetwarzać każdy nieaktywny plik *.log podczas kolejnych uruchomień. To proste i niezawodne, ale może nadpisać wyniki i tworzyć duplikaty w dalszym przetwarzaniu, jeśli kolektor nie deduplikuje.
• Konsolidacja wielu DC: -ComputerName $env:COMPUTERNAME jest dołączone, aby zestawy danych pozostały możliwe do śledzenia.
• Walidacja: walidacja nagłówka pozostaje włączona, ponieważ zadanie nie używa -SkipHeaderValidation (zalecane).

Walidacja i dostosowanie (z użyciem ZIP)

Użyj archiwum ZIP jako implementacji referencyjnej, a następnie dostosuj następujące aspekty do swojego środowiska:

• Zakres docelowy: które DC / OU otrzymują politykę
• Tożsamość wykonania: potwierdź, że oba zadania zaplanowane używają zamierzonego typu logowania (S4U vs InteractiveToken) lub ujednolić je do swojego standardu
• Tworzenie folderów: zdecyduj, czy C:\Administration\Scripts i C:\Administration\Logs\DNSServer są przygotowane gdzie indziej, czy mają być tworzone przez dodatkowe elementy GPP
• Ścieżki: potwierdź, że C:\Administration\Scripts i C:\Administration\Logs\DNSServer odpowiadają twoim standardom
• Retencja: zdecyduj, czy zachować surowe dzienniki i na jak długo (szczególnie jeśli włączasz opcje czyszczenia)
• Pobieranie: potwierdź, gdzie zapisywane są pliki CSV/ZIP i jak są centralnie zbierane

Jeśli chcesz zweryfikować dokładną konfigurację GPO bez importowania, autorytatywne źródła w tym repozytorium to:

• manifest.xml dla metadanych kopii zapasowej
• gpreport.xml dla pełnego raportu czytelnego dla człowieka
• Files.xml dla wdrożenia plików
• Set-DNSServerDebugLogging.ps1 dla zawartości skryptu
• ScheduledTasks.xml dla zadań zaplanowanych