This document details the operations you can perform on a Windows virtual
machine (VM). Windows VMs require Unified Extensible Firmware Interface (UEFI)
firmware to boot. To configure UEFI when you create a VM, see
[Create a Windows instance](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/vms/create-a-vm/create-manage-windows-vm.md.txt#create-windows-instance). For more information
about Windows support in Google Distributed Cloud (GDC) air-gapped, see
[GDC-supported Windows operating systems](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/vms/create-a-vm/supported-vm-images.md.txt#windows-os).

## Create a Windows instance

To create a Windows VM instance, complete the following steps:

1. Create a custom image by importing a Windows installation disk. For
   instructions, see
   [Import virtual disks](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/vms/create-custom-images/import-virtual-disk.md.txt#api).

2. [Create a VM instance from the custom image](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/vms/create-a-vm/create-and-start.md.txt#create-vm-from-custom).

3. Enable UEFI firmware for the VM. Windows VMs require UEFI. If you create the
   VM using the API, set
   [`bootType`](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#shieldconfig)
   to `uefi` in your `VirtualMachine` manifest. Using an unsupported boot type
   causes the instance to fail to boot:

   ```yaml
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
   spec:
     # ...
     shieldConfig:
       bootType: uefi
   ```

   Replace `VM_NAME` with the name of the VM.

## Manage Windows VMs

You can also manage user accounts and reset passwords on Windows instances using
the `VirtualMachinePasswordResetRequest` custom resource. After you've configured
credentials, you can connect to a Windows instance using a remote desktop client.

For more information about configuring credentials and connecting to Windows VMs, see
[Connect to a Windows VM](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/vms/connect-to-vm/connect-to-a-vm.md.txt#connect-to-a-windows-vm).