HTTP 500.22, 500.23 i 500.24 – ustawienie ASP.NET nie ma zastosowania w trybie Integrated managed pipeline

500.22, 500.23 i 500.24 w IIS: httpModules, httpHandlers i impersonacja w trybie zintegrowanym. Wykonaj appcmd migrate config lub użyj puli Classic.

  • Windows Server · Tryb zintegrowany i ISAPI
  • Poziom: średni
  • Czas: 15–30 minut
  • 500.22
  • 500.23
  • 500.24
  • httpModules
  • httpHandlers
  • identity impersonate

Na czym polega problem

Trzy kody z rodziny 500.2x mają wspólną przyczynę i wspólny komunikat: wykryto ustawienie ASP.NET, które nie ma zastosowania w trybie Integrated managed pipeline. Różnią się tym, o które ustawienie chodzi – 500.22 dotyczy sekcji httpModules, 500.23 sekcji httpHandlers, a 500.24 impersonacji (identity impersonate).

IIS w ten sposób pilnuje starszych aplikacji. W trybie zintegrowanym moduły i handlery konfiguruje się w jednej, wspólnej sekcji system.webServer, więc wpisy w starych sekcjach system.web nie zadziałałyby. Zamiast po cichu je pominąć, serwer zgłasza błąd i podpowiada polecenie migracji. Dla 500.22 i 500.23 Microsoft zaleca właśnie migrację.

Objawy

  • Strona błędu z numerem 500.22, 500.23 lub 500.24 i zdaniem o ustawieniu ASP.NET, które nie ma zastosowania w trybie zintegrowanym.
  • Szczegóły błędu zawierają gotowe polecenie appcmd migrate config z nazwą aplikacji.
  • Aplikacja działała w poprzedniej wersji IIS lub w puli w trybie Classic.
  • Błąd pojawił się po przeniesieniu aplikacji na serwer z IIS 7 lub nowszym albo po zmianie trybu puli na Integrated.

Najczęstsze przyczyny

  1. 500.22: web.config aplikacji zawiera sekcję httpModules, która ładuje lub usuwa moduły ASP.NET, a w trybie zintegrowanym moduły muszą być w system.webServer/modules.
  2. 500.23: web.config zawiera sekcję httpHandlers z własnymi mapowaniami handlerów, które w trybie zintegrowanym należą do system.webServer/handlers.
  3. 500.24: aplikacja używa impersonacji klienta (identity impersonate="true"), która w trybie zintegrowanym nie jest dostępna na niektórych wczesnych etapach przetwarzania żądania.
  4. Aplikacja pochodzi ze starszej wersji IIS albo z puli w trybie klasycznym i nigdy nie była migrowana do konfiguracji zintegrowanej.

Rozwiązanie krok po kroku

  1. Ustal, który kod i która aplikacja zgłaszają błąd

    Odczytaj kod (500.22, 500.23 lub 500.24) oraz ścieżkę aplikacji, na przykład Default Web Site/app1. Strona błędu podaje także pełne polecenie migracji.

  2. Dla 500.22 i 500.23 wykonaj migrację konfiguracji

    Uruchom wiersz poleceń jako administrator i wywołaj polecenie z wypisaną ścieżką aplikacji. Narzędzie przeniesie moduły i handlery do wspólnej sekcji; po migracji aplikacja powinna działać zarówno w trybie zintegrowanym, jak i klasycznym.

    %windir%\system32\inetsrv\appcmd migrate config "Default Web Site/app1"
  3. Dla 500.24 oceń, czy impersonacja jest potrzebna na wczesnych etapach

    Microsoft zaznacza, że w większości przypadków brak impersonacji na wczesnych etapach nie przeszkadza i wtedy można wyłączyć komunikat. Jeżeli aplikacja wymaga impersonacji w tych etapach, uruchom ją w puli w trybie klasycznym.

  4. Wyłączanie sprawdzania ustawiaj świadomie

    Komunikat można wyłączyć ustawieniem validateIntegratedModeConfiguration na false (w pliku web.config aplikacji to element validation w sekcji system.webServer). Microsoft nie zaleca tego, jeśli nie przeniesiono konfiguracji ręcznie. Serwer przestaje wtedy ostrzegać o nieobsługiwanych ustawieniach, więc przetestuj aplikację dokładnie.

    %windir%\system32\inetsrv\appcmd set config "Default Web Site/app1" -section:system.webServer/validation /validateIntegratedModeConfiguration:false
  5. Alternatywa: przenieś aplikację do puli w trybie Classic

    Utwórz pulę w trybie klasycznym albo użyj puli Classic .NET AppPool, jeśli instalacja ASP.NET ją utworzyła, a potem przypisz do niej aplikację. Inne aplikacje zostają w trybie zintegrowanym.

    %windir%\system32\inetsrv\appcmd set app "Default Web Site/app1" /applicationPool:"Classic .NET AppPool"
  6. Zmiana trybu istniejącej puli

    Możesz też zmienić tryb potoku całej puli, ale dotknie to wszystkich aplikacji w tej puli, więc zrób to w oknie serwisowym.

    %windir%\system32\inetsrv\appcmd set apppool /apppool.name:"NazwaPuli" /managedPipelineMode:Classic
  7. Utrzymuj zgodność konfiguracji po migracji

    Po migracji serwer nie zapyta ponownie. Jeśli później zmienisz moduły lub handlery w którymkolwiek miejscu, powtórz migrację ręcznie tym samym poleceniem, aby oba tryby miały spójną konfigurację.

Jak zapobiegać

  • Przy migracji aplikacji do nowego IIS zaczynaj od pojedynczej aplikacji w osobnej puli i dopiero po teście przenoś resztę.
  • Zapisuj, które aplikacje wymagają impersonacji, i trzymaj je w osobnej puli w trybie klasycznym.
  • Po ręcznych zmianach modułów i handlerów powtarzaj appcmd migrate config.
  • Przechowuj w repozytorium wersję web.config zgodną z oboma trybami.

W firmie

Starsze aplikacje intranetowe i formularze wewnętrzne mogą mieć stare sekcje httpModules i httpHandlers, a dopiero przeniesienie na nowy serwer IIS ujawnia te błędy. Zanim ktoś przełączy tryb potoku całej puli, sprawdź, ile innych aplikacji z niej korzysta. Pomagamy firmom z Radości i okolic w migracjach takich systemów: sprawdzamy konfigurację przed przenosinami, wykonujemy migrację appcmd i testujemy aplikację na kopii, zanim dotkniemy produkcji.

Pytania i odpowiedzi

Czy po migracji aplikacja nadal zadziała w trybie klasycznym?

Tak. Według Microsoftu po migracji aplikacja działa zarówno w trybie zintegrowanym, jak i klasycznym, o ile konfiguracja pozostaje zsynchronizowana.

Czy mogę po prostu ustawić validateIntegratedModeConfiguration na false?

Możesz, ale to ukrywa ostrzeżenie, a nie naprawia konfiguracji. Zalecaną drogą dla 500.22 i 500.23 jest migracja, a dla 500.24 – ocena potrzeby impersonacji lub tryb klasyczny.

Źródła

Opracowanie: zespół REDBAX – serwis komputerowy i obsługa informatyczna firm, Warszawa-Wawer. Stan na 02.11.2026. Kroki wykonujesz na własną odpowiedzialność – przed zmianami w systemie zrób kopię ważnych danych.

Serwer stoi, a firma czeka?

Administrujemy serwerami Windows w firmach z Warszawy i okolic. Zdiagnozujemy problem zdalnie, a gdy trzeba – przyjedziemy.