> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references/org/devices/add-autopilot-device.md).

# Agregar dispositivo a Autopilot

Registrar un dispositivo Windows en Windows Autopilot

### Descripción

Registra un dispositivo Windows en Windows Autopilot a partir de su número de serie y hash de hardware, tal como se recopilan con Get-WindowsAutopilotInfo. Opcionalmente, se establece una etiqueta de grupo durante la importación y el runbook espera hasta que la importación haya finalizado.

### Ubicación

Organización → Dispositivos → Agregar dispositivo Autopilot

**Nombre completo del runbook**

rjgit-org\_devices\_add-autopilot-device

### Detalles

| Propiedad          | Valor                               |
| ------------------ | ----------------------------------- |
| Versión            | 1.0.2                               |
| Módulos requeridos | RealmJoin.RunbookHelper (>= 0.8.10) |
| Programable        | no                                  |

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Importa el número de serie y el hash de hardware como dispositivo Autopilot y consulta periódicamente el trabajo de importación*
  * User.Read.All *(opcional — característica: Asignación de usuario)*
    * *Resuelve el UPN del usuario asignado cuando se proporciona AssignedUser*

### Parámetros

#### SerialNumber

Número de serie del dispositivo, según lo informa Get-WindowsAutopilotInfo.

| Propiedad                      | Valor           |
| ------------------------------ | --------------- |
| Requerido                      | verdadero       |
| Valor predeterminado           |                 |
| Tipo                           | Cadena          |
| Nombre para mostrar del portal | Número de serie |

#### HardwareIdentifier

Hash de hardware del dispositivo, según lo informa Get-WindowsAutopilotInfo.

| Propiedad                      | Valor            |
| ------------------------------ | ---------------- |
| Requerido                      | verdadero        |
| Valor predeterminado           |                  |
| Tipo                           | Cadena           |
| Nombre para mostrar del portal | Hash de hardware |

#### AssignedUser

Usuario al que se asignará durante la importación. Microsoft ya no acepta esto, así que déjelo vacío.

| Propiedad                      | Valor                                                       |
| ------------------------------ | ----------------------------------------------------------- |
| Requerido                      | falso                                                       |
| Valor predeterminado           |                                                             |
| Tipo                           | Cadena                                                      |
| Nombre para mostrar del portal | Asignar el dispositivo a este usuario (opcional)            |
| Oculto en el portal            | sí (preconfigurado mediante la personalización del runbook) |

#### Esperar

Mantiene el runbook en ejecución hasta que Autopilot haya procesado la importación, para que el resultado aparezca en la salida.

| Propiedad                      | Valor                                   |
| ------------------------------ | --------------------------------------- |
| Requerido                      | falso                                   |
| Valor predeterminado           | Verdadero                               |
| Tipo                           | Booleano                                |
| Nombre para mostrar del portal | ¿Esperar a que finalice la importación? |

#### GroupTag

Etiqueta de grupo que se establecerá en el dispositivo, por ejemplo para dirigirlo a un perfil de Autopilot. Déjelo vacío si no desea ninguna.

| Propiedad                      | Valor             |
| ------------------------------ | ----------------- |
| Requerido                      | falso             |
| Valor predeterminado           |                   |
| Tipo                           | Cadena            |
| Nombre para mostrar del portal | Etiqueta de grupo |

[Volver a la vista general de referencia del runbook](/es/automatizacion/runbooks/runbook-references.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references/org/devices/add-autopilot-device.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.