# Usage

## OOBE

The easiest way to use AutopilotOOBE is in OOBE (Out of Box Experience).  Open a command prompt by pressing **Shift + F10**

![](/files/-MbtAcT4REYoI0Q1rLHn)

## Install AutopilotOOBE PowerShell Module

You will need to set the PowerShell Execution Policy, install the AutopilotOOBE Module, and run AutopilotOOBE.  This is easy to do with the following commands

```
PowerShell
Set-ExecutionPolicy RemoteSigned -Force
Install-Module AutopilotOOBE -Force
Import-Module AutopilotOOBE -Force
```

## Start-AutopilotOOBE

Once the AutopilotOOBE PowerShell Module is installed, you can start AutopilotOOBE

```
Start-AutopilotOOBE
```

This will start the following chain of events

* PowerShell Transcript will be saved in C:\Windows\Temp
* PowerShell Gallery (PSGallery) will be Trusted
* Date and Time will be displayed
* Event Log will be monitored for MDM Events
* Network will be tested for connectivity to required Servers
  * You may need to open Firewall traffic as needed
* Registry will be checked to determine if the Device has an Autopilot Profile
* AutopilotOOBE GUI will be launched

![](/files/-MhRej-z4cWlOwOa9oVk)

## Watch-AutopilotOOBEevents

Event Logs will be monitored for MDM, Autopilot, and Time events.  Not all events are displayed as this is filtered to remove some unnecessary details

This PowerShell window is run minimized and remains open upon completion. You can view this for troubleshooting by pressing ALT + TAB, or review the output in the PowerShell Transcript that is saved in C:\Temp

![](/files/-MhRjsKua0nksVQeK4QS)

You may find it necessary to adjust your screen resolution to see things better.  You can 'Show Windows Settings'  and adjust the Resolution or Scaling as needed

![](/files/-MhRkpdhHe6SOq24g4IM)

![](/files/-MhRkycwSSd13E3VTlri)

![](/files/-MhRk52jBcGuBAKtBHWD)

## Test-AutopilotOOBEnetwork

This PowerShell window is run minimized and remains open upon completion. You can view this for troubleshooting by pressing ALT + TAB, or review the output in the PowerShell Transcript that is saved in C:\Temp

![](/files/-MhRf3cntozgb5wHJzFH)

## AutopilotOOBE GUI

AutopilotOOBE will load with all options available in an unconfigured state.  From here, just set what you want and press Register to connect to Microsoft Graph

![](/files/-MhRjbA1_FHf8ID49jEC)

Everybody's settings are probably going to be unique. Here are the settings that are ideal for my environment

![](/files/-MhRm7cGMaybWb1WL_0t)

After pressing Register the following steps will be completed

1. Get-WindowsAutopilotInfo will be installed from the PowerShell Gallery
2. Depending on what was selected in the AutopilotOOBE GUI, parameters will be passed to Get-WindowsAutopilotInfo
3. You will be prompted to authenticate to MSGraph using the credentials for your Tenant
4. Next

![](/files/-MfuzslafQUn72A-Mc7b)

Once you complete this step, in a few minutes your Device will be Registered.  If you selected the Assign checkbox, you may have to wait up to 20 minutes for this process to complete

## Sponsors

{% embed url="<https://www.recastsoftware.com/?utm_source=osdeploy&utm_medium=ad&utm_campaign=web>" %}
OSDeploy is sponsorted by Recast Software
{% endembed %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://autopilotoobe.osdeploy.com/usage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.