<!--
{
  "availability" : [
    "macOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Virtualization",
  "identifier" : "/documentation/Virtualization/VZMacGuestProvisioningOptions",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Virtualization"
    ],
    "preciseIdentifier" : "c:objc(cs)VZMacGuestProvisioningOptions"
  },
  "title" : "VZMacGuestProvisioningOptions"
}
-->

# VZMacGuestProvisioningOptions

The configuration for guest setup during macOS virtual machine startup.

```
class VZMacGuestProvisioningOptions
```

## Overview> Note: This configuration requires guest macOS 27 or later to function properly. Earlier versions
> of macOS don’t support the automated guest configuration protocol and ignore these settings.

This configuration class provides automated setup capabilities for macOS virtual machines
that allow hosts to configure a user account and initial setup workflows without
manual intervention during the guest boot process.

The configuration enables automated macOS installation and setup workflows by providing user
credentials and setup preferences to the guest system during startup.

macOS only evaluates these options on the first boot after restore. The Virtualization framework can’t use them
to reconfigure macOS once the framework has already provisioned it.

Changes to the properties after starting the virtual machine have no effect.

## See Also

[`VZGuestProvisioningOptions`](/documentation/Virtualization/VZGuestProvisioningOptions)

The base class for guest provisioning options.

[`VZMacOSVirtualMachineStartOptions`](/documentation/Virtualization/VZMacOSVirtualMachineStartOptions)

A class that describes start options for macOS VMs.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)