> 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/user/general/assign-windows365.md).

# Asignar Windows 365

Aprovisionar un Cloud PC de Windows 365 para este usuario

### Descripción

Asigna a este usuario los grupos que activan el aprovisionamiento de Windows 365: la directiva de aprovisionamiento o la asignación Frontline, la directiva de configuración del usuario y, para un Cloud PC dedicado, el grupo de licencia. Opcionalmente, el usuario recibe un correo electrónico cuando el Cloud PC está listo, y se abre un ticket de servicio por correo electrónico cuando no quedan licencias ni plazas Frontline.

### Ofrece los grupos de directiva y de licencia como menús desplegables

La directiva de aprovisionamiento, la directiva de configuración del usuario y el grupo de licencia son, de forma predeterminada, campos de texto sin formato. Con la personalización del runbook, conviértelos en menús desplegables con los nombres de grupo de tu Tenant:

```json
"rjgit-user_general_assign-windows365": {
    "Parameters": {
        "cfgProvisioningGroupName": {
            "SelectSimple": {
                "cfg - Windows 365 - Provisioning - Win11": "cfg - Windows 365 - Provisioning - Win11",
                "cfg - Windows 365 - Provisioning - Win10": "cfg - Windows 365 - Provisioning - Win10"
            }
        },
        "cfgUserSettingsGroupName": {
            "SelectSimple": {
                "cfg - Windows 365 - User Settings - restore allowed": "cfg - Windows 365 - User Settings - restore allowed",
                "cfg - Windows 365 - User Settings - no restore": "cfg - Windows 365 - User Settings - no restore"
            }
        },
        "licWin365GroupName": {
            "SelectSimple": {
                "lic - Windows 365 Enterprise - 2 vCPU 4 GB 128 GB": "lic - Windows 365 Enterprise - 2 vCPU 4 GB 128 GB",
                "lic - Windows 365 Enterprise - 2 vCPU 4 GB 256 GB": "lic - Windows 365 Enterprise - 2 vCPU 4 GB 256 GB"
            }
        }
    }
}
```

Los prefijos de nombre de los grupos (`cfgProvisioningGroupPrefix`, `cfgUserSettingsGroupPrefix`) determinan qué grupos cuentan como grupos de aprovisionamiento o de configuración del usuario; ajústalos en el mismo lugar cuando tu nomenclatura sea diferente.

Para obtener más información sobre cómo personalizar runbooks, consulte la [Guía de personalización de runbooks](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### Ubicación

Usuario → General → Asignar Windows365

**Nombre completo del runbook**

rjgit-user\_general\_assign-windows365

### 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
  * User.Read.All
    * *Resuelve el usuario de destino por UPN y comprueba la existencia del buzón antes de enviar el correo*
  * GroupMember.ReadWrite.All
    * *Agrega al usuario a los grupos de aprovisionamiento, de configuración del usuario y de licencias*
  * Group.ReadWrite.All
    * *Busca los grupos de configuración y de licencias y lee las licencias asignadas*
  * Mail.Send *(opcional — característica: informe por correo electrónico)*
    * *Envía el ticket por falta de licencias y la notificación al usuario cuando las opciones de correo estén habilitadas*
  * CloudPC.Read.All
    * *Lee las directivas de aprovisionamiento, los planes de servicio de uso compartido y los Cloud PCs del usuario*
  * Organization.Read.All
    * *Lee /subscribedSkus para verificar una licencia gratuita de Windows 365 en la ruta del plan dedicado*

### Parámetros

#### Nombre de usuario

Nombre principal de usuario del usuario sobre el que actúa el runbook. Lo establece el portal a partir del usuario seleccionado.

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

#### cfgProvisioningGroupName

Grupo de directiva de aprovisionamiento para un Cloud PC dedicado, o el nombre de la directiva de aprovisionamiento Frontline. Escribe el nombre, o selecciónalo cuando la personalización de tu runbook ofrezca una lista.

| Propiedad                      | Valor                                                 |
| ------------------------------ | ----------------------------------------------------- |
| Requerido                      | falso                                                 |
| Valor predeterminado           | cfg - Windows 365 - Provisioning - Win11              |
| Tipo                           | Cadena                                                |
| Nombre para mostrar del portal | Directiva de aprovisionamiento o asignación Frontline |

#### cfgUserSettingsGroupName

Grupo que contiene la directiva de configuración del usuario, por ejemplo, si el usuario puede restaurar el Cloud PC.

| Propiedad                      | Valor                                               |
| ------------------------------ | --------------------------------------------------- |
| Requerido                      | falso                                               |
| Valor predeterminado           | cfg - Windows 365 - User Settings - restore allowed |
| Tipo                           | Cadena                                              |
| Nombre para mostrar del portal | Directiva de configuración del usuario              |

#### licWin365GroupName

Grupo de licencias para un Cloud PC dedicado. No es necesario para Frontline.

| Propiedad                      | Valor                                             |
| ------------------------------ | ------------------------------------------------- |
| Requerido                      | falso                                             |
| Valor predeterminado           | lic - Windows 365 Enterprise - 2 vCPU 4 GB 128 GB |
| Tipo                           | Cadena                                            |
| Nombre para mostrar del portal | Licencia de Windows 365 (Cloud PC dedicado)       |

#### cfgProvisioningGroupPrefix

Prefijo de nombre que identifica los grupos de directiva de aprovisionamiento. Preconfigurado en la personalización del runbook.

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

#### cfgUserSettingsGroupPrefix

Prefijo de nombre que identifica los grupos de directiva de configuración del usuario. Preconfigurado en la personalización del runbook.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado | cfg - Windows 365 - User Settings -                         |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### sendMailWhenProvisioned

Envía un correo electrónico al usuario tan pronto como finaliza el aprovisionamiento.

| Propiedad                      | Valor                                                |
| ------------------------------ | ---------------------------------------------------- |
| Requerido                      | falso                                                |
| Valor predeterminado           | Falso                                                |
| Tipo                           | Booleano                                             |
| Nombre para mostrar del portal | ¿Notificar al usuario cuando el Cloud PC esté listo? |

#### customizeMail

Reemplaza el texto estándar de notificación por tu propio mensaje. Solo se usa cuando se notifica al usuario.

| Propiedad                      | Valor                                                |
| ------------------------------ | ---------------------------------------------------- |
| Requerido                      | falso                                                |
| Valor predeterminado           | Falso                                                |
| Tipo                           | Booleano                                             |
| Nombre para mostrar del portal | ¿Personalizar el correo electrónico de notificación? |

**Opciones del portal**

| Opción del portal                   | Valor     |
| ----------------------------------- | --------- |
| Usar el correo electrónico estándar | falso     |
| Usar un mensaje personalizado       | verdadero |

#### customMailMessage

Texto del correo electrónico de notificación.

| Propiedad                      | Valor                                                           |
| ------------------------------ | --------------------------------------------------------------- |
| Requerido                      | falso                                                           |
| Valor predeterminado           | Inserte aquí el mensaje personalizado. (Máximo 3000 caracteres) |
| Tipo                           | Cadena                                                          |
| Nombre para mostrar del portal | Mensaje personalizado                                           |

#### createTicketOutOfLicenses

Envía un correo electrónico de ticket al servicio de asistencia cuando no haya ninguna licencia o plaza Frontline disponible.

| Propiedad                      | Valor                                                        |
| ------------------------------ | ------------------------------------------------------------ |
| Requerido                      | falso                                                        |
| Valor predeterminado           | Falso                                                        |
| Tipo                           | Booleano                                                     |
| Nombre para mostrar del portal | ¿Abrir un ticket de servicio cuando se agoten las licencias? |

#### ticketQueueAddress

Buzón del servicio de asistencia que convierte el correo electrónico en un ticket.

| Propiedad                      | Valor                            |
| ------------------------------ | -------------------------------- |
| Requerido                      | falso                            |
| Valor predeterminado           | <support@glueckkanja-gab.com>    |
| Tipo                           | Cadena                           |
| Nombre para mostrar del portal | Dirección del ticket de servicio |

#### fromMailAddress

Buzón desde el que se envían los correos electrónicos de notificación y de ticket.

| Propiedad                      | Valor                  |
| ------------------------------ | ---------------------- |
| Requerido                      | falso                  |
| Valor predeterminado           | <runbooks@contoso.com> |
| Tipo                           | Cadena                 |
| Nombre para mostrar del portal | Buzón del remitente    |

#### ticketCustomerId

Identificador del cliente que se incluye en el asunto del ticket.

| Propiedad                      | Valor                      |
| ------------------------------ | -------------------------- |
| Requerido                      | falso                      |
| Valor predeterminado           | Contoso                    |
| Tipo                           | Cadena                     |
| Nombre para mostrar del portal | ID de cliente para tickets |

[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/user/general/assign-windows365.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.