KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

IIS.ServiceMonitor

★ 139 Open GitHub ↗

An entrypoint process for running IIS in Windows containers

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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            | *                                                                                                                                                                          |
| PROGRAMFILES(X86)       | *                                                                                                                                                                          |
| PROGRAMW6432            | *                                                                                                                                                                          |
| SYSTEMDRIVE             | *                                                                                                                                                                          |
| WINDIR                  | *                                                                                                                                                                          |
| NUMBER_OF_PROCESSORS    | *                                                                                                                                                                          |
| PROCESSOR_ARCHITECTURE  | *                                                                                                                                                                          |
| SYSTEMROOT              | *                                                                                                                                                                          |
| COMMONPROGRAMFILES      | *                                                                                                                                                                          |
| COMMONPROGRAMFILES(X86) | *                                                                                                                                                                          |
| COMMONPROGRAMW6432      | *                                                                                                                                                                          |
| DRIVERDATA              | *                                                                                                                                                                          |

## Build

```
.\build.cmd
```

## Usage

```
ServiceMonitor.exe [<windows_service_name> [application_pool]] [-st <service_timeout>] [-at <appcmd_timeout>]
```

|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|

### Examples

```
ServiceMonitor.exe
```
```
ServiceMonitor.exe -st 60
```
```
ServiceMonitor.exe w3svc ApplicationPool
```
```
ServiceMonitor.exe -at 30
```
```
ServiceMonitor.exe w3svc MyAppPool -st 60 -at 30
```
```
.\ServiceMonitor.exe w3svc
```

ServiceMonitor is currently distributed as part of the [IIS](https://hub.docker.com/_/microsoft-windows-servercore-iis),
[ASP.NET](https://hub.docker.com/_/microsoft-dotnet-framework-aspnet), and [WCF](https://hub.docker.com/_/microsoft-dotnet-framework-wcf) images on Docker Hub. We recommend layering your project on top of those official images as running
ServiceMonitor directly in your Dockerfile.

## Contributing

This project welcomes contributions and suggestions.  Most contributions require
you to agree to a Contributor License Agreement (CLA) declaring that you have
the right to, and actually do, grant us the rights to use your contribution. For
details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether
you need to provide a CLA and decorate the PR appropriately (e.g., label,
comment). Simply follow the instructions provided by the bot. You will only need
to do this once across all repos using our CLA.

This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any
additional questions or comments.

IIS.ServiceMonitor

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README