# Windows

{% columns %}
{% column %}
Deploy Alma on Windows to **monitor IIS runtime traffic** with zero app code changes.

The Alma Windows Sensor instruments IIS and exports telemetry to your Alma collector endpoint.

If you’re new to Alma, start with [Alma Overview](/about-alma/quickstart.md).
{% endcolumn %}

{% column %}
![](https://upload.wikimedia.org/wikipedia/commons/thumb/5/5f/Windows_logo_-_2012.svg/256px-Windows_logo_-_2012.svg.png)
{% endcolumn %}
{% endcolumns %}

### Prerequisites

* Ensure outbound TCP **port 4317** is open (gRPC).
* Confirm outbound firewall rules allow egress from:
  * the Windows host
  * your cloud/network perimeter (if applicable)
* Local admin access on the Windows host.

### Install

{% stepper %}
{% step %}

### 1) Extract the sensor files

Unzip the package and place these files in one folder:

* `AlmaWindowsSensor.psm1`
* `AlmaSensor.dll`
  {% endstep %}

{% step %}

### 2) Open PowerShell as Administrator

Open an elevated PowerShell session.

Then `cd` into the folder that contains the extracted files.
{% endstep %}

{% step %}

### 3) Import the module

```powershell
Import-Module .\AlmaWindowsSensor.psm1 -Force
```

{% endstep %}

{% step %}

### 4) Install the sensor

```powershell
Install-AlmaSensor
```

{% endstep %}

{% step %}

### 5) Register the sensor

```powershell
Register-Sensor
```

You will be prompted for:

* Alma collector endpoint
* Service name suffix
* SSL verification option

<figure><img src="/files/Y3iCLLRhi7nzcWBGqY2q" alt="PowerShell output for Install-AlmaSensor and Register-Sensor, showing the interactive prompts."><figcaption><p>Example output for installation + registration prompts.</p></figcaption></figure>
{% endstep %}

{% step %}

### 6) Instrument IIS

Instrument **all** IIS sites:

```powershell
Enable-GlobalInstrumentation
```

Instrument a **single** site:

```powershell
Enable-WebsiteInstrumentation -WebsiteName "YourSiteName"
```

{% hint style="warning" %}
Do not instrument both globally and per-site at the same time.
{% endhint %}

<figure><img src="/files/lEX5qJk9RNnZTwVqYuJJ" alt="PowerShell output for Enable-GlobalInstrumentation."><figcaption><p>Example output for global IIS instrumentation.</p></figcaption></figure>
{% endstep %}

{% step %}

### 7) Verify installation

Check **IIS Manager → Modules** for `AlmaWindowsSensor`.

Or run:

```powershell
Show-AlmaSensorStatus
```

<figure><img src="/files/aFlTglCb5wXJHinCuTIg" alt="PowerShell output for Show-AlmaSensorStatus."><figcaption><p>Example output for <code>Show-AlmaSensorStatus</code>.</p></figcaption></figure>

<figure><img src="/files/Hqjl87nP57kJiWi5R6VV" alt="IIS Manager showing Modules with AlmaWindowsSensor installed."><figcaption><p>IIS Manager → Modules showing <code>AlmaWindowsSensor</code>.</p></figcaption></figure>
{% endstep %}

{% step %}

### 8) Uninstall (if needed)

Run in PowerShell as Administrator:

```powershell
Disable-GlobalInstrumentation
Unregister-Sensor
Uninstall-AlmaSensor
```

{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.alma-security.com/integrations/windows.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.