> 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/device/general/change-grouptag.md).

# Cambiar etiqueta de grupo

Asigna una nueva etiqueta de grupo Autopilot a este dispositivo

### Descripción

Establece una nueva etiqueta de grupo de Windows Autopilot en este dispositivo. La etiqueta de grupo decide qué perfil de Autopilot y, a través de los grupos dinámicos, qué políticas y aplicaciones recibe el dispositivo, por lo que cambiarla prepara el dispositivo para una implementación diferente. No se cambia nada más en el dispositivo.

### Ubicación

Dispositivo → General → Cambiar etiqueta de grupo

**Nombre completo del runbook**

rjgit-device\_general\_change-groupTag

### Detalles

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

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * Device.Read.All
    * *Resuelve el dispositivo de Entra mediante /devices para obtener su nombre para mostrar*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Lee la identidad de Autopilot y establece la nueva etiqueta de grupo mediante updateDeviceProperties*

### Parámetros

#### DeviceId

ID de dispositivo de Entra ID del dispositivo sobre el que actúa el runbook. Lo establece el portal a partir del dispositivo seleccionado.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | verdadero                                                   |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### newGroupTag

Etiqueta de grupo que decide qué perfil de Autopilot y grupos dinámicos obtiene el dispositivo.

| Propiedad                      | Valor                   |
| ------------------------------ | ----------------------- |
| Requerido                      | falso                   |
| Valor predeterminado           |                         |
| Tipo                           | Cadena                  |
| Nombre para mostrar del portal | Nueva 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/device/general/change-grouptag.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.