---
title: "pause(completionHandler:)"
framework: virtualization
role: symbol
role_heading: Instance Method
path: "virtualization/vzvirtualmachine/pause(completionhandler:)"
---

# pause(completionHandler:)

Pauses a running VM and notifies the specified completion handler of the results.

## Declaration

```swift
func pause(completionHandler: @escaping (Result<Void, any Error>) -> Void)
```

## Parameters

- `completionHandler`: The block to call with the results of the pause attempt. This block has no return value and has one doc://com.apple.documentation/documentation/Foundation/NSError object as its parameter:

## Discussion

Discussion Call this method to pause a Vm that’s in the VZVirtualMachine.State.running state. To determine if a virtual machine is in a state that allows you to pause it, check the VM’s canPause property.

## See Also

### Starting and stopping the VM

- [start(completionHandler:)](virtualization/vzvirtualmachine/start(completionhandler:).md)
- [start()](virtualization/vzvirtualmachine/start().md)
- [start(options:completionHandler:)](virtualization/vzvirtualmachine/start(options:completionhandler:).md)
- [stop(completionHandler:)](virtualization/vzvirtualmachine/stop(completionhandler:).md)
- [requestStop()](virtualization/vzvirtualmachine/requeststop().md)
- [resume(completionHandler:)](virtualization/vzvirtualmachine/resume(completionhandler:).md)
- [pause()](virtualization/vzvirtualmachine/pause().md)
- [resume()](virtualization/vzvirtualmachine/resume().md)
- [VZVirtualMachineStartOptions](virtualization/vzvirtualmachinestartoptions.md)