> 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 desencadenan el aprovisionamiento de Windows 365: la directiva de aprovisionamiento o la asignación de Frontline, la directiva de configuración de usuario y, para un Cloud PC dedicado, el grupo de licencia. Opcionalmente, el usuario recibe un correo electrónico una vez que el Cloud PC está listo, y se abre un ticket de servicio por correo electrónico cuando no quedan licencias ni puestos de Frontline.

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

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

```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 grupo (`cfgProvisioningGroupPrefix`, `cfgUserSettingsGroupPrefix`) determinan qué grupos cuentan como grupos de aprovisionamiento o de configuración de 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 mediante UPN y comprueba la existencia del buzón antes de enviar correos*
  * GroupMember.ReadWrite.All
    * *Añade al usuario a los grupos de aprovisionamiento, de configuración de usuario y de licencia*
  * Group.ReadWrite.All
    * *Busca los grupos de configuración y de licencia y lee sus licencias asignadas*
  * Mail.Send *(opcional — característica: informe por correo electrónico)*
    * *Envía el ticket de 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 disponible 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                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | true                                                        |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### cfgProvisioningGroupName

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

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

#### cfgUserSettingsGroupName

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

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

#### licWin365GroupName

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

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

#### cfgProvisioningGroupPrefix

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

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

#### cfgUserSettingsGroupPrefix

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

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

#### sendMailWhenProvisioned

Envía al usuario un correo electrónico en cuanto finaliza el aprovisionamiento.

| Propiedad                        | Valor                                                |
| -------------------------------- | ---------------------------------------------------- |
| Obligatorio                      | falso                                                |
| Valor predeterminado             | Falso                                                |
| Tipo                             | Booleano                                             |
| Nombre para mostrar en el 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                                                |
| -------------------------------- | ---------------------------------------------------- |
| Obligatorio                      | falso                                                |
| Valor predeterminado             | Falso                                                |
| Tipo                             | Booleano                                             |
| Nombre para mostrar en el 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       | true  |

#### customMailMessage

Texto del correo electrónico de notificación.

| Propiedad                        | Valor                                                               |
| -------------------------------- | ------------------------------------------------------------------- |
| Obligatorio                      | falso                                                               |
| Valor predeterminado             | Inserta aquí el mensaje personalizado. (Limitado a 3000 caracteres) |
| Tipo                             | Cadena                                                              |
| Nombre para mostrar en el portal | Mensaje personalizado                                               |

#### createTicketOutOfLicenses

Envía un correo con un ticket al servicio de asistencia cuando no hay ninguna licencia o puesto de Frontline disponible.

| Propiedad                        | Valor                                                        |
| -------------------------------- | ------------------------------------------------------------ |
| Obligatorio                      | falso                                                        |
| Valor predeterminado             | Falso                                                        |
| Tipo                             | Booleano                                                     |
| Nombre para mostrar en el 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                            |
| -------------------------------- | -------------------------------- |
| Obligatorio                      | falso                            |
| Valor predeterminado             | <support@glueckkanja-gab.com>    |
| Tipo                             | Cadena                           |
| Nombre para mostrar en el portal | Dirección del ticket de servicio |

#### fromMailAddress

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

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

#### ticketCustomerId

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

| Propiedad                        | Valor                      |
| -------------------------------- | -------------------------- |
| Obligatorio                      | falso                      |
| Valor predeterminado             | Contoso                    |
| Tipo                             | Cadena                     |
| Nombre para mostrar en el portal | ID de cliente para tickets |

[Volver al resumen de referencia de Runbook](https://docs.realmjoin.com/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.
