> 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 acionam o provisionamento do Windows 365: a política de provisionamento ou a atribuição Frontline, a política de definições do utilizador e, para um Cloud PC dedicado, o grupo de licenças. Opcionalmente, o utilizador recebe um e-mail assim que o Cloud PC estiver pronto, e é aberto por e-mail um ticket de serviço quando não restarem licenças nem lugares Frontline.

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

A política de provisionamento, a política de definições do utilizador e o grupo de licenças são campos de texto simples por predefinição. 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 de aplicativo

* **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 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 Cloud PCs 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 do usuário no qual o runbook atua. Definido pelo portal a partir do usuário selecionado.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | verdadeiro                                              |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio 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 Frontline. Escreva o nome ou selecione-o quando a personalização do runbook oferecer uma lista.

| Propriedade                | Valor                                               |
| -------------------------- | --------------------------------------------------- |
| Obrigatório                | falso                                               |
| Valor padrão               | cfg - Windows 365 - Provisioning - Win11            |
| Tipo                       | Texto                                               |
| Nome de exibição no portal | Política de provisionamento ou atribuição 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 padrão               | cfg - Windows 365 - User Settings - restore allowed |
| Tipo                       | Texto                                               |
| Nome de exibição no 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 padrão               | lic - Windows 365 Enterprise - 2 vCPU 4 GB 128 GB |
| Tipo                       | Texto                                             |
| Nome de exibição no portal | Licença Windows 365 (Cloud PC dedicado)           |

#### cfgProvisioningGroupPrefix

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

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | cfg - Windows 365 - Provisioning -                      |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### cfgUserSettingsGroupPrefix

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

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | cfg - Windows 365 - User Settings -                     |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### sendMailWhenProvisioned

Envia ao utilizador um e-mail assim que o provisionamento terminar.

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

#### customizeMail

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

| Propriedade                | Valor                                 |
| -------------------------- | ------------------------------------- |
| Obrigatório                | falso                                 |
| Valor padrão               | Falso                                 |
| Tipo                       | Booleano                              |
| Nome de exibição no portal | Personalizar o e-mail de notificação? |

**Opções do portal**

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

#### customMailMessage

Texto do e-mail de notificação.

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

#### createTicketOutOfLicenses

Envia um e-mail de ticket para o serviço de apoio quando não houver nenhuma licença nem lugar Frontline disponível.

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

#### ticketQueueAddress

Caixa de correio do serviço de apoio que converte o e-mail num ticket.

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

#### fromMailAddress

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

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

#### ticketCustomerId

Identificador do cliente incluído no assunto do ticket.

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

[Voltar à visão geral da referência do runbook](https://docs.realmjoin.com/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.
