> 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/reprovision-windows365.md).

# Reprovisionar Windows365

### Descrição

Aciona uma ação de reprovisionamento para um Cloud PC existente do Windows 365 sem atribuir uma nova instância. Opcionalmente, notifica o utilizador quando o reprovisionamento começa.

### Localização

Utilizador → Geral → Reprovision Windows365

**Nome completo do runbook**

rjgit-user\_general\_reprovision-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
  * GroupMember.ReadWrite.All
    * *Lê os membros do grupo de licenças para confirmar que o utilizador possui a licença Windows 365*
  * Group.ReadWrite.All
    * *Encontra o grupo de licenças pelo nome apresentado e lê as respetivas licenças atribuídas*
  * Directory.Read.All
    * *Lê /subscribedSkus para mapear o SKU do grupo para planos de serviço e corresponder ao Cloud PC*
  * CloudPC.ReadWrite.All
    * *Lista os Cloud PCs do utilizador e aciona a ação de reprovisionamento*
  * User.Read.All
    * *Resolve o utilizador pelo UPN e verifica a presença da caixa de correio antes de enviar o e-mail*
  * Mail.Send *(opcional — funcionalidade: relatório por e-mail)*
    * *Notifica o utilizador através de /users/{from}/sendMail quando sendMailWhenReprovisioning está ativado*

### 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) |

#### licWin365GroupName

Nome apresentado do grupo de licenças Windows 365 usado para identificar o Cloud PC.

| Propriedade                | Valor                                                              |
| -------------------------- | ------------------------------------------------------------------ |
| Obrigatório                | verdadeiro                                                         |
| Valor padrão               | lic - Windows 365 Enterprise - 2 vCPU 4 GB 128 GB                  |
| Tipo                       | String                                                             |
| Nome de exibição no portal | Selecione a licença Windows 365 a ser usada para reprovisionamento |

**Opções do portal**

| Opção do portal                                   | Valor                                             |
| ------------------------------------------------- | ------------------------------------------------- |
| 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 |

#### sendMailWhenReprovisioning

"Não enviar um e-mail." (valor final: $false) ou "Enviar um e-mail." (valor final: $true) podem ser selecionados como ação a executar. Se definido como true, será enviada uma notificação por e-mail ao utilizador quando o reprovisionamento do Cloud PC tiver começado.

| Propriedade                | Valor                                                                         |
| -------------------------- | ----------------------------------------------------------------------------- |
| Obrigatório                | falso                                                                         |
| Valor padrão               | Falso                                                                         |
| Tipo                       | Booleano                                                                      |
| Nome de exibição no portal | Notificar o utilizador quando o reprovisionamento do Cloud PC tiver começado? |

**Opções do portal**

| Opção do portal       | Valor |
| --------------------- | ----- |
| Não enviar um e-mail. |       |
| Enviar um e-mail.     |       |

#### fromMailAddress

Caixa de correio usada para enviar o e-mail de notificação.

| Propriedade                | Valor                                                           |
| -------------------------- | --------------------------------------------------------------- |
| Obrigatório                | falso                                                           |
| Valor padrão               | <reports@contoso.com>                                           |
| Tipo                       | String                                                          |
| Nome de exibição no portal | (Partilhada) Caixa de correio a partir da qual enviar o e-mail: |

#### 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.                |

[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/reprovision-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.
