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

# Atribuir Windows 365

Provisionar um Cloud PC do Windows 365 para este utilizador

### Descrição

Atribui a este utilizador os grupos que desencadeiam o provisionamento do Windows 365: a política de provisionamento ou a atribuição de Frontline, a política de definições do utilizador e, para um Cloud PC dedicado, o grupo de licença. Opcionalmente, o utilizador recebe um email quando o Cloud PC estiver pronto, e é aberto por email um ticket de serviço quando já não houver licenças nem lugares Frontline disponíveis.

### Ofereça as políticas e os grupos de licença como menus suspensos

A política de provisionamento, a política de definições do utilizador e o grupo de licenças são, por defeito, campos de texto simples. Transforme-os em menus suspensos com os nomes dos grupos do seu tenant através da personalização do 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"
            }
        }
    }
}
```

Os prefixos dos nomes dos grupos (`cfgProvisioningGroupPrefix`, `cfgUserSettingsGroupPrefix`) determinam quais grupos contam como grupos de provisionamento ou de definições do utilizador; ajuste-os no mesmo local quando a sua nomenclatura for diferente.

Para mais informações sobre como personalizar runbooks, consulte o [Guia de Personalização de Runbooks](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### Localização

Utilizador → Geral → Atribuir Windows365

**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.10) |
| Agendável           | não                                 |

### Permissões

#### Permissões da 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 de enviar o email*
  * 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 email)*
    * *Envia o ticket de falta de licenças e a notificação ao utilizador quando as opções de email estão ativadas*
  * CloudPC.Read.All
    * *Lê as políticas de provisionamento, os planos de serviço de utilização partilhada e os Cloud PCs do utilizador*
  * Organization.Read.All
    * *Lê /subscribedSkus para verificar uma licença do Windows 365 disponível no caminho do plano dedicado*

### Parâmetros

#### Nome de utilizador

Nome principal do utilizador sobre o qual o runbook atua. Definido pelo portal a partir do utilizador selecionado.

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | verdadeiro                                             |
| Valor predefinido |                                                        |
| Tipo              | Cadeia de caracteres                                   |
| Oculto no portal  | sim (predefinido através da personalização do runbook) |

#### cfgProvisioningGroupName

Grupo de política de provisionamento para um Cloud PC dedicado, ou o nome da política de provisionamento de Frontline. Introduza o nome, ou escolha-o quando a personalização do seu runbook oferecer uma lista.

| Propriedade                | Valor                                                  |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório                | falso                                                  |
| Valor predefinido          | cfg - Windows 365 - Provisioning - Win11               |
| Tipo                       | Cadeia de caracteres                                   |
| Nome de exibição do portal | Política de provisionamento ou atribuição de Frontline |

#### cfgUserSettingsGroupName

Grupo que contém a política de definições do utilizador, por exemplo, se o utilizador pode restaurar o Cloud PC.

| Propriedade                | Valor                                               |
| -------------------------- | --------------------------------------------------- |
| Obrigatório                | falso                                               |
| Valor predefinido          | cfg - Windows 365 - User Settings - restore allowed |
| Tipo                       | Cadeia de caracteres                                |
| Nome de exibição do portal | Política de definições do utilizador                |

#### licWin365GroupName

Grupo de licenças para um Cloud PC dedicado. Não necessário para Frontline.

| Propriedade                | Valor                                             |
| -------------------------- | ------------------------------------------------- |
| Obrigatório                | falso                                             |
| Valor predefinido          | lic - Windows 365 Enterprise - 2 vCPU 4 GB 128 GB |
| Tipo                       | Cadeia de caracteres                              |
| Nome de exibição do portal | Licença do Windows 365 (Cloud PC dedicado)        |

#### cfgProvisioningGroupPrefix

Prefixo de nome que identifica grupos de políticas de provisionamento. Predefinido na personalização do runbook.

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | falso                                                  |
| Valor predefinido | cfg - Windows 365 - Provisioning -                     |
| Tipo              | Cadeia de caracteres                                   |
| Oculto no portal  | sim (predefinido através da personalização do runbook) |

#### cfgUserSettingsGroupPrefix

Prefixo de nome que identifica grupos de políticas de definições do utilizador. Predefinido na personalização do runbook.

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | falso                                                  |
| Valor predefinido | cfg - Windows 365 - User Settings -                    |
| Tipo              | Cadeia de caracteres                                   |
| Oculto no portal  | sim (predefinido através da personalização do runbook) |

#### sendMailWhenProvisioned

Envia ao utilizador um email assim que o provisionamento estiver concluído.

| Propriedade                | Valor                                                    |
| -------------------------- | -------------------------------------------------------- |
| Obrigatório                | falso                                                    |
| Valor predefinido          | Falso                                                    |
| Tipo                       | Booleano                                                 |
| Nome de exibição do portal | Notificar o utilizador quando o Cloud PC estiver pronto? |

#### customizeMail

Substitui o texto padrão da notificação pela sua própria mensagem. Usado apenas quando o utilizador é notificado.

| Propriedade                | Valor                                |
| -------------------------- | ------------------------------------ |
| Obrigatório                | falso                                |
| Valor predefinido          | Falso                                |
| Tipo                       | Booleano                             |
| Nome de exibição do portal | Personalizar o email de notificação? |

**Opções do portal**

| Opção do portal                 | Valor      |
| ------------------------------- | ---------- |
| Usar o email padrão             | falso      |
| Usar uma mensagem personalizada | verdadeiro |

#### customMailMessage

Texto do email de notificação.

| Propriedade                | Valor                                                              |
| -------------------------- | ------------------------------------------------------------------ |
| Obrigatório                | falso                                                              |
| Valor predefinido          | Insira aqui a mensagem personalizada. (Limitado a 3000 caracteres) |
| Tipo                       | Cadeia de caracteres                                               |
| Nome de exibição do portal | Mensagem personalizada                                             |

#### createTicketOutOfLicenses

Envia um email de ticket para a equipa de suporte quando não está disponível nenhuma licença ou lugar Frontline.

| Propriedade                | Valor                                                       |
| -------------------------- | ----------------------------------------------------------- |
| Obrigatório                | falso                                                       |
| Valor predefinido          | Falso                                                       |
| Tipo                       | Booleano                                                    |
| Nome de exibição do portal | Abrir um ticket de serviço quando as licenças se esgotarem? |

#### ticketQueueAddress

Caixa de correio do service desk que transforma o email num ticket.

| Propriedade                | Valor                         |
| -------------------------- | ----------------------------- |
| Obrigatório                | falso                         |
| Valor predefinido          | <support@glueckkanja-gab.com> |
| Tipo                       | Cadeia de caracteres          |
| Nome de exibição do portal | Endereço do ticket de serviço |

#### fromMailAddress

Caixa de correio a partir da qual são enviados os emails de notificação e de ticket.

| Propriedade                | Valor                         |
| -------------------------- | ----------------------------- |
| Obrigatório                | falso                         |
| Valor predefinido          | <runbooks@contoso.com>        |
| Tipo                       | Cadeia de caracteres          |
| Nome de exibição do portal | Caixa de correio do remetente |

#### ticketCustomerId

Identificador do cliente incluído no assunto do ticket.

| Propriedade                | Valor                      |
| -------------------------- | -------------------------- |
| Obrigatório                | falso                      |
| Valor predefinido          | Contoso                    |
| Tipo                       | Cadeia de caracteres       |
| Nome de exibição do portal | ID do cliente para tickets |

[Voltar à visão geral da referência do Runbook](/pt/automatizacao/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/pt/automatizacao/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.