dfsdiag

Komenda dfsdiag to narzędzie wiersza poleceń dostępne w systemach Windows Server z rolą Distributed File System (DFS). Umożliwia diagnostykę i weryfikację stanu usługi DFS Namespace oraz DFS Replication. Dzięki niej administrator może testować przekierowania (referrals), połączenia replikacji, aktywność, a także uzyskać informacje o serwerach członkowskich, konfiguracji przestrzeni nazw i wydajności protokołu RPC.

Składnia

dfsdiag [ /testreferral:<ścieżka_udziału> ]
       [ /testdfsrconnectivity ]
       [ /testdfsractivity ]
       [ /testgch ]
       [ /pktstats ]
       [ /spconfig ]
       [ /servers:<nazwa_domeny> ]
       [ /domain:<nazwa_domeny> ]
       [ /v ]
       [ /? ]

• Każda opcja może być wywołana wielokrotnie w jednym poleceniu.
• Przełącznik /v włącza tryb szczegółowy (verbose).
• /help lub /?” wyświetla pomoc online.

Parametry

Parametr	Opis
/testreferral:<ścieżka_udziału>	Sprawdza, czy klient może prawidłowo uzyskać przekierowanie DFS dla podanej ścieżki (np. \\dc1\\share).
/testdfsrconnectivity	Weryfikuje łączność RPC pomiędzy wszystkimi członkami repliki DFSR w bieżąym środowisku domenowym.
/testdfsractivity	Pokazuje status transferów i stan kolejki replikacji DFSR dla wszystkich grup replikacyjnych na danym serwerze.
/testgch	Testuje Global Client Health – sprawdza, czy logika klienta DFS działa poprawnie na maszynach klienckich.
/pktstats	Zbiera statystyki pakietów RPC używanych przez DFS/DFSR, pomocne przy analizie wydajności sieciowej.
/spconfig	Wyświetla ustawienia Timeout i Max Packet Size dla RPC DFS.
/servers:<nazwa_domeny>	Testuje stan DFS dla wszystkich serwerów członkowskich w podanej domenie.
/domain:<nazwa_domeny>	Określa domenę, w której wykonywane są testy DFS Namespace i DFSR.
/v	Włącza tryb verbose, pokazuje pełne informacje diagnostyczne.
/?	Wyświetla listę dostępnych opcji i krótkie opisy.

Przykłady użycia

1. Test przekierowania do udziału DFS

   dfsdiag /testreferral:\\contoso.com\\dfsroot\\share

   Sprawdza, czy klient otrzymuje prawidłowy adres serwera obsługującego udział.

2. Weryfikacja łączności replikacji DFSR

   dfsdiag /testdfsrconnectivity

   Upewnia się, że połączenia RPC pomiędzy członkami grupy replikacji są aktywne.

3. Raport aktywności replikacji

   dfsdiag /testdfsractivity

   Pokazuje informacje o statusie przesyłania plików i ewentualnych błędach w kolejkach.

4. Statystyki pakietów RPC

   dfsdiag /pktstats

   Prezentuje liczbę i wielkość pakietów RPC używanych przez usługę DFS.

5. Szczegółowy raport wszystkich testów

   dfsdiag /testreferral:\\contoso.com\\dfsroot /testdfsrconnectivity /testdfsractivity /v

   Uruchamia kilka testów jednocześnie z pełnym wydrukiem informacji.

Uwagi

• dfsdiag wymaga uruchomienia w sesji z uprawnieniami administratora na kontrolerze domeny lub serwerze członkowskim z rolą DFS Namespace/DFS Replication.

• Testy /testdfsrconnectivity i /testdfsractivity działają tylko w środowiskach z usługą DFS Replication (DFSR).

• Przy dużych środowiskach domenowych zaleca się użycie parametrów /servers lub /domain w celu ograniczenia zakresu testów.

• Wyniki /pktstats i /spconfig przydatne przy diagnostyce problemów z zaporami oraz optymalizacją MTU sieci.

• W scenariuszach awaryjnych można przekierować wynik do pliku tekstowego:

  dfsdiag /testdfsractivity > C:\Logs\dfsr_activity.log

Najczęściej spotykane błędy i jak je naprawić

Błąd / Komunikat	Przyczyna	Rozwiązanie
RPC server is unavailable	Blokada portów RPC lub nazwy serwera w DNS nie rozwiązują się.	Sprawdź reguły zapory (porty 135, 445, zakres dynamiczny RPC) oraz wpisy DNS dla kontrolerów i serwerów DFS.
The target is not a valid DFS path	Niepoprawna ścieżka przekazana do /testreferral.	Zweryfikuj poprawność namespace DFS, użyj pełnej ścieżki UNC do udziału.
No replication groups found	Brak skonfigurowanej replikacji DFSR na tym serwerze.	Upewnij się, że rola DFS Replication jest zainstalowana i skonfigurowana w danej domenie.
Access is denied	Brak uprawnień do odpytywania metadanych DFS lub replikacji.	Uruchom narzędzie jako administrator domeny lub członek grupy DFS-Admins.
TestGCH failed	Usługa DFS Namespace lub DFSR nie działa poprawnie na klientach.	Sprawdź stan usług DFS Namespace i DFS Replication, zrestartuj je w razie potrzeby.