windows-server-2019

windows-server-2019-vs2019 is a Windows Server 2019 machine executor image with Visual Studio Code created by CircleCI with continuous integration builds in mind.

See the docs page for information on getting started using Windows on CircleCI.

For more customization options, we offer a VM Service as well with dedicated Windows virtual machines running bespoke and static images.

Getting Started

To use the Windows executor and the available Windows images, it is easiest to utilize the Windows orb:

1
2
3
4
5
6
7
8
9
10
11
12
version: 2.1
orbs:
  win: circleci/windows@4.1
jobs:
  build:
    executor: win/server-2019
    steps:
      - run: Write-Host 'Hello, Windows'
workflows:
  my-workflow:
    jobs:
      - build

The above example uses the Windows orb Windows orb to easily access the Windows machine executor and image in a standardized way.

To use the image directly in the machine executor, you can use:

1
2
3
4
5
6
7
8
9
10
version: 2.1

jobs:
  build:
    machine:
      image: 'windows-server-2019-vs2019:2024.12.1'
      resource_class: windows.medium
      shell: powershell.exe -ExecutionPolicy Bypass
    steps:
      - run: Write-Host 'Hello, Windows'

Three shells are provided and can be specified within your command. The above uses powershell.exe, but you can run bash and cmd commands with bash.exe or cmd.exe, respectfully

How This Image Works

This image is based on Windows Server 2019 and contains various Linux and Windows utilities needed to run most builds on CircleCI. Images are typically updated and released every month.

Please visit our Discuss forums with any questions, search for common problems, or feature requests.

The past four updates in ascending order:

• February
• January
• November '21
• October '21

What's in the Box?

Windows Server 2019 Core Datacenter Edition

• Visual Studio 2019 Community Edition
  • Additional licensing terms may apply to your organisation when using this version of Visual Studio on CircleCI. Please review the Visual Studio 2019 Community Edition licensing terms before using this Visual Studio version in your Windows jobs.
  • Azure SDK for Visual Studio 2019
  • Visual Studio 2019 Build Tools
• 7zip
• AWS
  • AWS CLI
  • Python
  • Botocore
• Azure CLI
• Azure Service Fabric
  • SDK
  • Runtime
• Chocolatey
• Git
• Git LFS
• Go
• Gzip
• Java
• jq
• Miniconda
• Node.js
• NuGet CLI
• Nunit
• NVM (Node Version Manager)
• OpenJDK
• PsExec64
• Python
• Ruby
• .NET Framework 5
• .NET
  • SDK
  • .NET Core SDK
• Shells:
  • Powershell
  • GNU bash
  • cmd
• Text editors
  • nano
  • vim
• WinAppDriver
• Windows 10 SDK
• Yarn

Tagging Scheme

current - This image tag points to the latest, production ready Windows image. This image should be used by projects that want a decent level of stability but would like to get occasional software updates.

edge - This image tag points to the latest version of the Windows image and is built from the HEAD of the main branch. This tag is intended to be used as a testing version of the image with the most recent changes and not guaranteed to be stable

Image Tags