> For the complete CircleCI developer hub index, see [llms.txt](https://circleci.com/developer/llms.txt)

# circleci/windows

Execute your CI pipelines on Windows in the cloud with Nvidia GPU support.

## Executors

### default

An executor preloaded with Visual Studio 2022 plus a number of other development tools.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `shell` | string | powershell.exe -ExecutionPolicy Bypass | The shell to use. Defaults to `powershell.exe -ExecutionPolicy Bypass` |
| `size` | enum | medium | The size of Windows resource to use. Defaults to medium. |
| `variant` | enum | gui | The variant of windows server 2022. Defaults to gui. |
| `version` | string | current | The image version to use when executing. Defaults to "current". |

### server-2019

An executor preloaded with Visual Studio 2019 plus a number of other development tools.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `shell` | string | powershell.exe -ExecutionPolicy Bypass | The shell to use. Defaults to `powershell.exe -ExecutionPolicy Bypass` |
| `size` | enum | medium | The size of Windows resource to use. Defaults to medium. |
| `variant` | enum | vs2019 | The variant of Windows Server 2019. Defaults to vs2019. |
| `version` | string | current | The image version to use when executing. Defaults to "current". |

### server-2019-cuda

An executor with an Nvidia GPU which includes a pre-installed CUDA runtime and the cuDNN library.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `shell` | string | powershell.exe -ExecutionPolicy Bypass | The shell to use. Defaults to `powershell.exe -ExecutionPolicy Bypass` |
| `size` | enum | medium | The size of Windows GPU resource to use. Defaults to medium. |
| `version` | string | current | The image version to use when executing. Defaults to "current". |

### server-2022

An executor preloaded with Visual Studio 2022 plus a number of other development tools.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `shell` | string | powershell.exe -ExecutionPolicy Bypass | The shell to use. Defaults to `powershell.exe -ExecutionPolicy Bypass` |
| `size` | enum | medium | The size of Windows resource to use. Defaults to medium. |
| `variant` | enum | gui | The variant of Windows Server 2022. Defaults to gui. |
| `version` | string | current | The image version to use when executing. Defaults to "current". |

### server-2022-cuda

An executor with an Nvidia GPU which includes a pre-installed CUDA runtime.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `shell` | string | powershell.exe -ExecutionPolicy Bypass | The shell to use. Defaults to `powershell.exe -ExecutionPolicy Bypass` |
| `size` | enum | medium | The size of Windows GPU resource to use. Defaults to medium. |
| `version` | string | current | The image version to use when executing. Defaults to "current". |

### server-2025

An executor preloaded with Visual Studio 2022 plus a number of other development tools.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `shell` | string | powershell.exe -ExecutionPolicy Bypass | The shell to use. Defaults to `powershell.exe -ExecutionPolicy Bypass` |
| `size` | enum | medium | The size of Windows resource to use. Defaults to medium. |
| `variant` | enum | gui | The variant of Windows Server 2025. Defaults to gui. |
| `version` | string | current | The image version to use when executing. Defaults to "current". |

### server-2025-cuda

An executor with an Nvidia GPU which includes a pre-installed CUDA runtime and the cuDNN library.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `shell` | string | powershell.exe -ExecutionPolicy Bypass | The shell to use. Defaults to `powershell.exe -ExecutionPolicy Bypass` |
| `size` | enum | medium | The size of Windows GPU resource to use. Defaults to medium. |
| `version` | string | current | The image version to use when executing. Defaults to "current". |

## Examples

### run_default

This is an example of running a simple job on the default Windows executor

```yaml
version: '2.1'
orbs:
  win: circleci/windows@5.0
jobs:
  build:
    executor:
      name: win/default
    steps:
      - checkout
      - run: Write-Host 'Hello, Windows'
workflows:
  my-workflow:
    jobs:
      - build
```

### run_windows_2019

This is an example of running a simple job on the Windows Server 2019 executor


```yaml
version: '2.1'
orbs:
  win: circleci/windows@5.0
jobs:
  build:
    executor: win/server-2019
    steps:
      - run: Write-Host 'Hello, Windows'
workflows:
  my-workflow:
    jobs:
      - build
```

### run_windows_2019_cuda

This is an example of running a simple job on the Windows Server 2019 cuda (GPU) executor


```yaml
version: '2.1'
orbs:
  win: circleci/windows@5.0
jobs:
  build:
    executor: win/server-2019-cuda
    steps:
      - run: Write-Host 'Hello, Windows'
workflows:
  my-workflow:
    jobs:
      - build
```

### run_windows_2022

This is an example of running a simple job on the Windows Server 2022 executor


```yaml
version: '2.1'
orbs:
  win: circleci/windows@5.0
jobs:
  build:
    executor: win/server-2022
    steps:
      - run: Write-Host 'Hello, Windows'
workflows:
  my-workflow:
    jobs:
      - build
```

### run_windows_2022_cuda

This is an example of running a simple job on the Windows Server 2022 cuda (GPU) executor


```yaml
version: '2.1'
orbs:
  win: circleci/windows@5.0
jobs:
  build:
    executor: win/server-2022-cuda
    steps:
      - run: Write-Host 'Hello, Windows'
workflows:
  my-workflow:
    jobs:
      - build
```

### run_windows_2025

This is an example of running a simple job on the Windows Server 2025 executor


```yaml
version: '2.1'
orbs:
  win: circleci/windows@5.1
jobs:
  build:
    executor: win/server-2025
    steps:
      - run: Write-Host 'Hello, Windows'
workflows:
  my-workflow:
    jobs:
      - build
```

### run_windows_2025_cuda

This is an example of running a simple job on the Windows Server 2025 cuda (GPU) executor


```yaml
version: '2.1'
orbs:
  win: circleci/windows@5.1
jobs:
  build:
    executor: win/server-2025-cuda
    steps:
      - run: Write-Host 'Hello, Windows'
workflows:
  my-workflow:
    jobs:
      - build
```