# cloudhv_vm_stop

Stop a running Cloud Hypervisor virtual machine.

```rhai
cloudhv_vm_stop(id, force) -> ()
```

## Parameters

- `id` (string): VM identifier
- `force` (bool): Force stop if true, graceful shutdown if false

## Returns

Returns nothing on success, throws error on failure.

## Examples

```rhai
// Graceful shutdown
cloudhv_vm_stop("myvm", false);

// Force stop
cloudhv_vm_stop("myvm", true);
```

## Notes

- Graceful shutdown (force=false) sends shutdown signal to guest
- Force stop (force=true) immediately terminates the VM process
- VM state is preserved for restart
- Use `cloudhv_vm_delete()` to completely remove the VM
