Microsoft IIS Service Monitor Microsoft

iis-service-monitor internet-information-services internetinformationservices requirescmd

Use this command to install Microsoft IIS Service Monitor:

winget install --id=Microsoft.IIS.ServiceMonitor -e

Microsoft IIS Service Monitor is a Windows executable designed to facilitate the operation of Internet Information Services (IIS) within Windows Server containers. It serves as an entrypoint process, enabling seamless integration of IIS into containerized environments.

Key Features:

Service Monitoring: Continuously tracks the status of the w3svc service and exits when it transitions from the running state to stopped, stopping pending, paused, or pausing pending states.
Environment Variable Promotion: Automatically transfers environment variables from the process environment block to the DefaultAppPool, with exceptions for predefined exclusions such as TEMP, USERNAME, and others.
Customizable Parameters: Supports command-line arguments like specifying the service name, application pool (defaulting to DefaultAppPool), service timeout (in seconds), and appcmd timeout (in seconds).
Compatibility: Designed to work with official IIS, ASP.NET, and WCF Docker images, allowing users to layer their projects on top of these base images.
Configuration Flexibility: Enables tailored configurations by modifying command-line parameters or integrating into custom Dockerfiles.

Audience & Benefit: Ideal for developers and DevOps professionals focused on containerized application development. This tool enhances operational reliability by automating the monitoring of IIS services within containers, thereby minimizing manual oversight and ensuring consistent service performance.

Install Microsoft IIS Service Monitor via winget to streamline your containerized IIS deployments.

Microsoft IIS Service Monitor

ServiceMonitor is a Windows executable designed to be used as the entrypoint process when running IIS inside a Windows Server container.

ServiceMonitor monitors the status of the w3svc service and will exit when the service state changes from SERVICE_RUNNING to either one of SERVICE_STOPPED, SERVICE_STOP_PENDING, SERVICE_PAUSED or SERVICE_PAUSE_PENDING.

Additionally, ServiceMonitor will promote environment variables from process environment it's own process environment block to the DefaultAppPool. We achieve this by naively copying all variables in our process environment block except for those Environment variable / value pairs present in this list below.

Environment variable exclusion list

Environment Variable	Value
TMP	"C:\Users\ContainerAdministrator\AppData\Local\Temp"
TEMP	"C:\Users\ContainerAdministrator\AppData\Local\Temp"
USERNAME	"ContainerAdministrator"
USERPROFILE	"C:\Users\ContainerAdministrator"
APPDATA	"C:\Users\ContainerAdministrator\AppData\Roaming"
LOCALAPPDATA	"C:\Users\ContainerAdministrator\AppData\Local"
PROGRAMDATA	"C:\ProgramData"
PSMODULEPATH	"%ProgramFiles%\WindowsPowerShell\Modules;C:\Windows\system32\WindowsPowerShell\v1.0\Modules"
PUBLIC	"C:\Users\Public"
USERDOMAIN	"User Manager"
ALLUSERSPROFILE	"C:\ProgramData"
PATHEXT	".COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH;.MSC"
PATH	*
COMPUTERNAME	*
COMSPEC	*
OS	*
PROCESSOR_IDENTIFIER	*
PROCESSOR_LEVEL	*
PROCESSOR_REVISION	*
PROGRAMFILES

Placeholder	Description
`windows_service_name`	Name of the Windows service to monitor
`application_pool`	Name of the application pool to monitor; defaults to DefaultAppPool
`service_timeout`	The time (in seconds) it is willing to wait for the service to start or stop
`appcmd_timeout`	The time (in seconds) it is willing to wait for the appcmd command to execute

Microsoft IIS Service Monitor Microsoft

README

Microsoft IIS Service Monitor

Environment variable exclusion list

Build

Usage

Examples

Contributing