Skip to main content

How to Delete an Application Pool in IIS from Batch Script

Over time, IIS servers accumulate orphaned application pools left behind by decommissioned websites, failed deployments, or testing sessions. These unused pools clutter the IIS Manager, can consume resources if accidentally started, and create confusion for administrators trying to understand the server's configuration. Automating their removal via Batch Script is a clean, repeatable way to maintain a tidy IIS installation.

In this guide, we will explore how to safely delete application pools using the appcmd.exe command-line tool within a Batch Script, including pre-deletion checks and dependency validation.

Prerequisites​

  • IIS must be installed with appcmd.exe at %SystemRoot%\System32\inetsrv\.
  • Administrator privileges are required.
  • The pool must not be assigned to any websites or applications.

Method 1: Simple Application Pool Deletion​

@echo off
setlocal

set "appcmd=%SystemRoot%\System32\inetsrv\appcmd.exe"
set "pool_name=OldTestPool"

:: Verify Admin
net session >nul 2>&1
if %errorlevel% neq 0 (
    echo [ERROR] Administrator privileges required.
    pause
    exit /b 1
)

echo Deleting application pool "%pool_name%"...

"%appcmd%" delete apppool /apppool.name:"%pool_name%"

if %errorlevel% equ 0 (
    echo [SUCCESS] Application pool "%pool_name%" deleted.
) else (
    echo [ERROR] Failed to delete. The pool may not exist or may still be in use.
)

pause
endlocal

What Happens If the Pool Is In Use?​

If the application pool is currently assigned to one or more websites, appcmd delete apppool will fail with an error. You must first reassign or delete the dependent websites before the pool can be removed.

Method 2: Safe Deletion with Dependency Check​

A production-grade script should verify that no websites depend on the target pool before deletion.

@echo off
setlocal enabledelayedexpansion

set "appcmd=%SystemRoot%\System32\inetsrv\appcmd.exe"
set "pool_name=StagingPool"

net session >nul 2>&1
if !errorlevel! neq 0 (
    echo [ERROR] Admin required.
    pause
    exit /b 1
)

echo =============================================
echo   DELETING APPLICATION POOL: %pool_name%
echo =============================================
echo.

:: 1. Check if the pool exists
"%appcmd%" list apppool /name:"%pool_name%" >nul 2>&1
if !errorlevel! neq 0 (
    echo [INFO] Pool "%pool_name%" does not exist. Nothing to delete.
    pause
    exit /b 0
)

:: 2. Check for dependent applications
set "has_deps=0"
for /f "tokens=*" %%A in ('"%appcmd%" list app /apppool.name:"%pool_name%" 2^>nul') do (
    if !has_deps! equ 0 (
        echo [WARNING] The following applications use this pool:
        set "has_deps=1"
    )
    echo   %%A
)

if !has_deps! equ 1 (
    echo.
    echo [ABORT] Cannot delete pool while applications depend on it.
    echo Reassign or delete the dependent sites first.
    pause
    exit /b 1
)

:: 3. Stop the pool if running
echo Stopping pool...
"%appcmd%" stop apppool /apppool.name:"%pool_name%" >nul 2>&1

:: 4. Delete the pool
echo Deleting pool...
"%appcmd%" delete apppool /apppool.name:"%pool_name%"

if !errorlevel! equ 0 (
    echo [SUCCESS] "%pool_name%" deleted.
) else (
    echo [ERROR] Deletion failed.
)

pause
endlocal

Method 3: Force Deletion (Remove Dependencies First)​

If you want a script that forcefully removes both the pool and its dependent applications:

@echo off
setlocal enabledelayedexpansion

set "appcmd=%SystemRoot%\System32\inetsrv\appcmd.exe"
set "pool_name=LegacyPool"

net session >nul 2>&1
if !errorlevel! neq 0 (
    echo [ERROR] Admin required.
    pause
    exit /b 1
)

:: Check existence
"%appcmd%" list apppool /name:"%pool_name%" >nul 2>&1
if !errorlevel! neq 0 (
    echo [INFO] Pool "%pool_name%" not found.
    pause
    exit /b 0
)

echo Removing all applications from pool "%pool_name%"...

:: Find and reassign all apps using this pool
for /f "tokens=*" %%A in ('"%appcmd%" list app /apppool.name:"%pool_name%" /text:app.name 2^>nul') do (
    echo   Reassigning "%%A" to DefaultAppPool...
    "%appcmd%" set app /app.name:"%%A" /applicationPool:"DefaultAppPool" >nul 2>&1
)

:: Stop the pool
"%appcmd%" stop apppool /apppool.name:"%pool_name%" >nul 2>&1

:: Delete the pool
echo Deleting pool "%pool_name%"...
"%appcmd%" delete apppool /apppool.name:"%pool_name%"

if !errorlevel! equ 0 (
    echo [SUCCESS] Pool deleted. Dependent apps moved to DefaultAppPool.
) else (
    echo [ERROR] Failed.
)

pause
endlocal
warning

Reassigning production websites to DefaultAppPool is a temporary measure. After deletion, create new dedicated pools for any reassigned sites to maintain proper process isolation.

Method 4: Interactive Pool Deletion Tool​

@echo off
title Application Pool Cleanup
setlocal enabledelayedexpansion

set "appcmd=%SystemRoot%\System32\inetsrv\appcmd.exe"

net session >nul 2>&1
if !errorlevel! neq 0 (
    echo [ERROR] Run as Administrator.
    pause
    exit /b 1
)

:menu
cls
echo =============================================
echo       APPLICATION POOL CLEANUP
echo =============================================
echo.
echo Current Application Pools:
echo.

set "count=0"
for /f "tokens=*" %%P in ('"%appcmd%" list apppool') do (
    set /a "count+=1"
    echo   !count!. %%P
)

echo.
echo Enter the exact pool name to delete, or type EXIT:
echo.
set "target="
set /p "target=Pool name: "

if not defined target goto menu
if /i "!target!" == "EXIT" (
    endlocal
    exit /b 0
)

:: Confirm
echo.
echo About to DELETE: !target!
set "confirm="
set /p "confirm=Type YES to confirm: "
if /i not "!confirm!" == "YES" (
    echo [CANCELLED]
    pause
    goto menu
)

:: Protect built-in pools
if /i "!target!" == "DefaultAppPool" (
    echo [DENIED] Cannot delete DefaultAppPool.
    pause
    goto menu
)
if /i "!target!" == ".NET v4.5" (
    echo [DENIED] Cannot delete built-in .NET pools.
    pause
    goto menu
)
if /i "!target!" == ".NET v4.5 Classic" (
    echo [DENIED] Cannot delete built-in .NET pools.
    pause
    goto menu
)

:: Check existence before attempting deletion
"%appcmd%" list apppool /name:"!target!" >nul 2>&1
if !errorlevel! neq 0 (
    echo [ERROR] Pool "!target!" does not exist.
    pause
    goto menu
)

:: Execute
"%appcmd%" stop apppool /apppool.name:"!target!" >nul 2>&1
"%appcmd%" delete apppool /apppool.name:"!target!"

if !errorlevel! equ 0 (
    echo [OK] Deleted.
) else (
    echo [ERROR] Failed. May have dependent sites.
)

pause
goto menu

Bulk Cleanup: Removing All Unused Pools​

This advanced script scans for any pool that has zero applications assigned to it and deletes them (excluding protected system pools).

@echo off
setlocal enabledelayedexpansion

set "appcmd=%SystemRoot%\System32\inetsrv\appcmd.exe"

net session >nul 2>&1
if !errorlevel! neq 0 (
    echo [ERROR] Admin required.
    pause
    exit /b 1
)

echo Scanning for unused application pools...
echo.

set "deleted=0"

for /f "tokens=*" %%P in ('"%appcmd%" list apppool /text:name') do (
    set "pool=%%P"

    :: Check if pool is protected
    set "skip=0"
    if /i "!pool!" == "DefaultAppPool" set "skip=1"
    if /i "!pool!" == ".NET v4.5" set "skip=1"
    if /i "!pool!" == ".NET v4.5 Classic" set "skip=1"

    if !skip! equ 0 (
        :: Count apps assigned to this pool
        set "app_count=0"
        for /f "tokens=*" %%A in ('"%appcmd%" list app /apppool.name:"!pool!" 2^>nul') do (
            set /a "app_count+=1"
        )

        if !app_count! equ 0 (
            echo   Deleting unused pool: !pool!
            "%appcmd%" stop apppool /apppool.name:"!pool!" >nul 2>&1
            "%appcmd%" delete apppool /apppool.name:"!pool!" >nul 2>&1
            set /a "deleted+=1"
        ) else (
            echo   Skipping "!pool!" (!app_count! app(s^) assigned^)
        )
    )
)

echo.
echo Cleanup complete. Deleted !deleted! unused pool(s^).
pause
endlocal

Common Mistakes​

The Wrong Way: Deleting a Pool with Active Sites​

:: WRONG - Will fail if any site uses this pool
"%appcmd%" delete apppool /apppool.name:"ProductionPool"

Output Concern: The command returns an error because IIS prevents deleting pools that are assigned to websites. You must first reassign or delete the dependent sites.

The Wrong Way: Deleting DefaultAppPool​

:: WRONG - DefaultAppPool is the system fallback pool
"%appcmd%" delete apppool /apppool.name:"DefaultAppPool"

While IIS may allow this technically, deleting the DefaultAppPool can break the Default Web Site and any applications that do not have an explicit pool assignment. Never delete system-default pools.

Best Practices​

  1. Check dependencies first: Always verify no applications are assigned to the pool before attempting deletion.
  2. Stop before deleting: Stop the pool to ensure all worker processes terminate cleanly before removal.
  3. Protect built-in pools: Never delete DefaultAppPool or framework-provided pools like .NET v4.5.
  4. Log deletions: In production environments, log which pools were deleted and when for audit purposes.
  5. Confirm interactively: For manual cleanup tools, always require explicit confirmation before destructive operations.

Conclusion​

Deleting application pools from IIS via Batch Script is a single appcmd delete apppool command, but responsible administration demands pre-deletion dependency checks, protection of built-in pools, and clean shutdown sequences. By incorporating these safety measures into reusable scripts, administrators can confidently clean up abandoned pools across their server infrastructure without risking disruption to active production websites.

Table of Contents