> 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/pt/automacao/runbooks/runbook-references/user/general/assign-windows365.md).

# Atribuir Windows365

### Descrição

Atribui os grupos necessários e a licença ou a política de provisionamento FrontLine para iniciar o provisionamento do Windows 365. Opcionalmente, notifica o utilizador quando o provisionamento é concluído e pode criar um ticket de suporte quando as licenças se esgotam.

### Localização

Utilizador → Geral → Atribuir Windows 365

**Nome completo do runbook**

rjgit-user\_general\_assign-windows365

### Detalhes

| Propriedade         | Valor                              |
| ------------------- | ---------------------------------- |
| Versão              | 1.0.1                              |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.9) |
| Agendável           | não                                |

### Permissões

#### Permissões de aplicação

* **Tipo**: Microsoft Graph
  * User.Read.All
    * *Resolve o utilizador de destino pelo UPN e verifica a existência da caixa de correio antes do envio do e-mail*
  * GroupMember.ReadWrite.All
    * *Adiciona o utilizador aos grupos de provisionamento, de definições do utilizador e de licenças*
  * Group.ReadWrite.All
    * *Procura os grupos de configuração e de licenças e lê as licenças atribuídas*
  * Mail.Send *(opcional — funcionalidade: relatório por e-mail)*
    * *Envia o ticket de falta de licenças e a notificação ao utilizador quando as opções de e-mail estão ativadas*
  * CloudPC.Read.All
    * *Lê as políticas de provisionamento, os planos de serviço de utilização partilhada e os PCs na nuvem do utilizador*
  * Organization.Read.All
    * *Lê /subscribedSkus para verificar uma licença Windows 365 gratuita no caminho do plano dedicado*

### Parâmetros

#### Nome de usuário

Nome principal de usuário do usuário de destino.

| Propriedade      | Valor                                           |
| ---------------- | ----------------------------------------------- |
| Obrigatório      | verdadeiro                                      |
| Valor padrão     |                                                 |
| Tipo             | String                                          |
| Oculto no portal | sim (predefinido via personalização do runbook) |

#### cfgProvisioningGroupName

Nome a apresentar do grupo de política de provisionamento ou da atribuição FrontLine a utilizar.

| Propriedade                | Valor                                                         |
| -------------------------- | ------------------------------------------------------------- |
| Obrigatório                | falso                                                         |
| Valor padrão               | cfg - Windows 365 - Provisionamento - Win11                   |
| Tipo                       | String                                                        |
| Nome de exibição no portal | Política de provisionamento / Atribuição FrontLine a utilizar |

#### cfgUserSettingsGroupName

Nome a apresentar do grupo de política de definições do utilizador a utilizar.

| Propriedade                | Valor                                                             |
| -------------------------- | ----------------------------------------------------------------- |
| Obrigatório                | falso                                                             |
| Valor padrão               | cfg - Windows 365 - Definições do utilizador - restauro permitido |
| Tipo                       | String                                                            |
| Nome de exibição no portal | Política de definições do utilizador a utilizar                   |

#### licWin365GroupName

Nome a apresentar do grupo de licenças do Windows 365 a atribuir ao utilizar PCs na nuvem dedicados.

| Propriedade                | Valor                                                 |
| -------------------------- | ----------------------------------------------------- |
| Obrigatório                | falso                                                 |
| Valor padrão               | lic - Windows 365 Enterprise - 2 vCPU 4 GB 128 GB     |
| Tipo                       | String                                                |
| Nome de exibição no portal | Licença Windows 365 a atribuir (se não for FrontLine) |

#### cfgProvisioningGroupPrefix

Prefixo usado para detetar grupos de configuração relacionados com o provisionamento.

| Propriedade      | Valor                                           |
| ---------------- | ----------------------------------------------- |
| Obrigatório      | falso                                           |
| Valor padrão     | cfg - Windows 365 - Provisionamento -           |
| Tipo             | String                                          |
| Oculto no portal | sim (predefinido via personalização do runbook) |

#### cfgUserSettingsGroupPrefix

Prefixo usado para detetar grupos de configuração relacionados com as definições do utilizador.

| Propriedade      | Valor                                           |
| ---------------- | ----------------------------------------------- |
| Obrigatório      | falso                                           |
| Valor padrão     | cfg - Windows 365 - Definições do utilizador -  |
| Tipo             | String                                          |
| Oculto no portal | sim (predefinido via personalização do runbook) |

#### sendMailWhenProvisioned

Se definido como verdadeiro, envia um e-mail ao utilizador após a conclusão do provisionamento.

| Propriedade                | Valor                                                               |
| -------------------------- | ------------------------------------------------------------------- |
| Obrigatório                | falso                                                               |
| Valor padrão               | Falso                                                               |
| Tipo                       | Booleano                                                            |
| Nome de exibição no portal | Notificar o utilizador quando o CloudPC terminar o provisionamento? |

#### customizeMail

Se definido como verdadeiro, usa um corpo de e-mail personalizado.

| Propriedade                | Valor                                                    |
| -------------------------- | -------------------------------------------------------- |
| Obrigatório                | falso                                                    |
| Valor padrão               | Falso                                                    |
| Tipo                       | Booleano                                                 |
| Nome de exibição no portal | Gostaria de personalizar o e-mail enviado ao utilizador? |

#### customMailMessage

Corpo da mensagem personalizada usado para o e-mail de notificação.

| Propriedade                | Valor                                                              |
| -------------------------- | ------------------------------------------------------------------ |
| Obrigatório                | falso                                                              |
| Valor padrão               | Insira aqui a mensagem personalizada. (Limitado a 3000 caracteres) |
| Tipo                       | String                                                             |
| Nome de exibição no portal | Mensagem personalizada a ser enviada ao utilizador.                |

#### createTicketOutOfLicenses

Se definido como verdadeiro, cria um e-mail de ticket de serviço quando não houver licenças ou lugares FrontLine disponíveis.

| Propriedade                | Valor                                                                                     |
| -------------------------- | ----------------------------------------------------------------------------------------- |
| Obrigatório                | falso                                                                                     |
| Valor padrão               | Falso                                                                                     |
| Tipo                       | Booleano                                                                                  |
| Nome de exibição no portal | Criar um ticket de serviço (e-mail) se não houver licenças/lugares FrontLine suficientes? |

#### ticketQueueAddress

Endereço de e-mail usado como destinatário da fila de tickets.

| Propriedade                | Valor                                        |
| -------------------------- | -------------------------------------------- |
| Obrigatório                | falso                                        |
| Valor padrão               | <support@glueckkanja-gab.com>                |
| Tipo                       | String                                       |
| Nome de exibição no portal | Onde abrir um ticket de serviço (via e-mail) |

#### fromMailAddress

Caixa de correio usada para enviar o ticket e os e-mails de notificação ao utilizador.

| Propriedade                | Valor                              |
| -------------------------- | ---------------------------------- |
| Obrigatório                | falso                              |
| Valor padrão               | <runbooks@contoso.com>             |
| Tipo                       | String                             |
| Nome de exibição no portal | (Shared) Mailbox to send mail from |

#### ticketCustomerId

Identificador do cliente usado nas linhas de assunto dos tickets.

| Propriedade                | Valor                                           |
| -------------------------- | ----------------------------------------------- |
| Obrigatório                | falso                                           |
| Valor padrão               | Contoso                                         |
| Tipo                       | String                                          |
| Nome de exibição no portal | String do ID do cliente para tickets de serviço |

[Voltar à visão geral da referência do runbook](/pt/automacao/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 dynamically by asking a question.

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

```
GET https://docs.realmjoin.com/pt/automacao/runbooks/runbook-references/user/general/assign-windows365.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
