> 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/collab/pre-provision-onedrive.md).

# Pré-provisionar o OneDrive

Solicitar o OneDrive deste utilizador antes do primeiro início de sessão

### Descrição

Solicita o OneDrive deste utilizador no SharePoint Online para que ele esteja disponível antes do primeiro início de sessão. A conta tem de estar ativada e, quando a verificação de licença está ativada, ter um plano de serviço do SharePoint atribuído. Nada é solicitado se o OneDrive já existir. O SharePoint cria o OneDrive em segundo plano, normalmente em minutos e, por vezes, apenas após 24 horas, e a execução não espera por ele.

### Como funciona

Em cada execução, o runbook:

1. Liga-se ao Microsoft Graph e ao SharePoint Online (PnP PowerShell) com a identidade gerida da conta de Automation. O URL do centro de administração do SharePoint é derivado automaticamente a partir do site raiz do tenant.
2. Lê o utilizador selecionado (`Nome de usuário`) do Microsoft Entra ID e termina se a conta não existir ou estiver **desativados**.
3. Opcionalmente verifica se o utilizador tem um **SharePoint** plano de serviço (ver [Verificação de licença](#license-check)).
4. Verifica se o OneDrive do utilizador já existe como uma coleção de sites ativa — se assim for, a execução termina sem enviar um pedido.
5. Procura um OneDrive eliminado do utilizador no caixote de reciclagem do tenant e apresenta um aviso se for encontrado um.
6. Coloca na fila a criação do OneDrive através de `New-PnPPersonalSite` e apresenta o resultado.

O runbook é iniciado a partir do objeto de utilizador no portal RealmJoin, pelo que o utilizador é sempre pré-selecionado — não existe introdução de texto livre.

#### A conta tem de estar ativada

O SharePoint só cria um OneDrive para utilizadores com permissão para iniciar sessão. Os pedidos para utilizadores bloqueados são aceites, mas ignorados silenciosamente, o que resultaria numa mensagem enganadora de "colocado na fila". Por isso, o runbook termina com um erro quando `accountEnabled` esteja `falso`. Ative primeiro a conta e execute o runbook novamente.

Um bloqueio de início de sessão imposto por **Conditional Access** não pode ser detetado pelo runbook.

#### Verificação de licença

Com **Verificar primeiro a licença do SharePoint?** (`CheckSharePointLicense`, ativado por predefinição) o runbook termina quando o utilizador não tem nenhum plano de serviço do SharePoint ativado. A verificação avalia os `assignedPlans`, pelo que todas as origens de licenças contam:

* Conjuntos Microsoft 365 / Office 365 (por exemplo, E3, E5, F3, Business Standard)
* SharePoint Online Plan 1 / Plan 2 e planos autónomos do OneDrive
* Atribuições de licenças diretas e baseadas em grupos

Se a verificação estiver desativada, o pedido é colocado na fila na mesma — mas o SharePoint não criará o OneDrive enquanto não for atribuída nenhuma licença do SharePoint. Depois de atribuir uma licença, aguarde algum tempo para que a atribuição produza efeito antes de executar o runbook.

#### Idempotente por definição

* Se o OneDrive já existir como uma coleção de sites ativa, o runbook indica `AlreadyProvisioned` e não envia nenhum pedido.
* Enviar um pedido para um utilizador que já tem um OneDrive é inofensivo — o SharePoint ignora-o.

#### OneDrive eliminado no caixote de reciclagem

Se for encontrado no caixote de reciclagem do tenant um OneDrive eliminado do utilizador (correspondente ao proprietário do site), o runbook apresenta um aviso com o URL e a hora de eliminação. Restaurar o OneDrive existente pode ser preferível a criar um novo, vazio. O aviso não interrompe a execução.

#### Provisionamento assíncrono

O runbook apenas **coloca na fila** o pedido; o OneDrive é criado mais tarde por uma tarefa agendada do SharePoint. Isto geralmente demora alguns minutos, mas pode demorar até 24 horas ou mais. O runbook não espera pela conclusão — use o runbook **Verificar estado do OneDrive** (Org \\\ Collab) para verificar o resultado.

O runbook devolve um objeto com `UserPrincipalName`, `Status` (`AlreadyProvisioned` ou `ProvisioningRequested`), `OneDriveUrl` e `RequestedAt` (UTC).

#### Pré-requisitos

As permissões na **Office 365 SharePoint Online** API não podem ser atribuídas pela configuração automática de permissões para Microsoft Graph. Conceda-as uma vez por tenant à identidade gerida atribuída pelo sistema da conta de Automation antes da primeira execução.

### Localização

Utilizador → Collab → Pré-provisionar OneDrive

**Nome completo do runbook**

rjgit-user\_collab\_pre-provision-onedrive

### Detalhes

| Propriedade         | Valor                                                                                                                 |
| ------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Versão              | 1.0.1                                                                                                                 |
| Módulos necessários | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>PnP.PowerShell (>= 3.4.1)</p> |
| Agendável           | não                                                                                                                   |

### Permissões

#### Permissões de aplicativo

* **Tipo**: Microsoft Graph
  * Sites.Read.All
    * *Lê o site raiz do tenant (/sites/root) para derivar o URL do centro de administração do SharePoint usado por Connect-PnPOnline.*
  * User.Read.All
    * *Lê o utilizador selecionado (accountEnabled, userPrincipalName, assignedPlans) para verificar se a conta está ativada e, opcionalmente, se está atribuído um plano de serviço do SharePoint ativado antes de o pedido de provisionamento ser enviado.*
* **Tipo**: Office 365 SharePoint Online
  * Sites.FullControl.All
    * *Exigido por Connect-PnPOnline no centro de administração do SharePoint e pelos cmdlets de administração do tenant Get-PnPTenantSite, Get-PnPTenantDeletedSite e New-PnPPersonalSite, que inspecionam sites pessoais do OneDrive, o caixote de reciclagem do tenant e colocam na fila a criação do OneDrive; âmbitos de site inferiores não são suficientes para o ponto final de administração do tenant.*
  * User.ReadWrite.All
    * *Documentado pelo PnP PowerShell como necessário para New-PnPPersonalSite com permissões de aplicação (serviço de perfil de utilizador); também abrange a leitura de PersonalUrl através de Get-PnPUserProfileProperty.*

#### Notas de permissão

SharePoint Online: conceda as permissões de aplicação 'Sites.FullControl.All' e 'User.ReadWrite.All' na API Office 365 SharePoint Online (AppId 00000003-0000-0ff1-ce00-000000000000) à identidade gerida atribuída pelo sistema da conta de Automation. Esta concessão de app-only do SharePoint não pode ser efetuada através da automatização padrão de atribuição de funções de aplicações do Entra usada para Microsoft Graph e tem de ser atribuída manualmente por tenant.

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

#### CheckSharePointLicense

Quando ativado, o runbook para se este utilizador não tiver nenhum plano de serviço do SharePoint ativado de qualquer licença, atribuída diretamente ou por grupo. Quando desativado, o pedido é enviado na mesma, mas o SharePoint só cria o OneDrive depois de ser atribuída uma licença.

| Propriedade                | Valor                                       |
| -------------------------- | ------------------------------------------- |
| Obrigatório                | falso                                       |
| Valor padrão               | Verdadeiro                                  |
| Tipo                       | Booleano                                    |
| Nome de exibição no portal | Verificar primeiro a licença do SharePoint? |

[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/collab/pre-provision-onedrive.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.
