> 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/org/general/sync-shared-channel-owners_scheduled.md).

# Sincronizar proprietários do Shared Channel agendado

Tornar os membros de um grupo proprietários das equipas e Shared Channel mapeados

{% hint style="info" %}
Este é um runbook agendado. Ele foi projetado para ser executado em um agendamento recorrente, em vez de ser acionado para um único objeto. Consulte [Agendamento](https://docs.realmjoin.com/pt/automatizacao/runbooks/scheduling.md) para ver detalhes sobre como configurar agendamentos de runbook.
{% endhint %}

### Descrição

Os canais partilhados não herdam os proprietários da respetiva equipa. Para cada equipa nomeada no mapeamento, os membros do grupo de segurança mapeado tornam-se proprietários da equipa e de cada canal partilhado que esta aloja. Só adiciona, nunca remove; novos canais partilhados são incluídos na próxima execução. Uma execução de teste mostra as alterações sem as aplicar. O relatório pode ser enviado por e-mail ou disponibilizado como uma hiperligação de transferência.

### Como funciona

Em cada execução, o runbook:

1. Lê o mapeamento do nome da equipa para o grupo de proprietários a partir da definição da organização `SharedChannelOwners.Mapping`.
2. Para cada entrada, procura a equipa pelo seu **nome de apresentação exato**.
3. Expande o grupo de proprietários dessa entrada para os seus membros transitivos **utilizador** membros (os convidados são omitidos — não podem pertencer a um canal partilhado).
4. Garante que esses utilizadores são proprietários da equipa e de cada **alojado** canal partilhado da equipa.

O runbook é **apenas de adição**: nunca rebaixa nem remove proprietários ou membros existentes. Os canais partilhados recém-criados são, por isso, detetados automaticamente na próxima execução agendada, sem perturbar nada já existente.

#### Configuração do mapeamento

O mapeamento está centralizado nas definições da organização do RealmJoin (Personalização do Runbook → `Configurações` → `SharedChannelOwners.Mapping`) para ser mantido uma vez e partilhado por todos os agendamentos. É uma lista de `{ TeamName, OwnerGroupId }` objetos, em que `TeamName` é o **nome de apresentação exato da equipa**. O `TeamOwnerGroupMapping` parâmetro oculto é injetado a partir desta definição; o runbook aceita-o quer como um array estruturado (forma recomendada de subdefinição) quer como uma cadeia JSON e normaliza ambos.

Exemplo pronto a usar para as definições da organização:

```json
{
    "Settings": {
        "SharedChannelOwners": {
            "Mapping": [
                { "TeamName": "EXT Service A", "OwnerGroupId": "11111111-1111-1111-1111-111111111111" },
                { "TeamName": "EXT Service B", "OwnerGroupId": "22222222-2222-2222-2222-222222222222" }
            ]
        }
    }
}
```

#### Correspondência de equipas

Cada entrada do mapeamento tem como alvo uma equipa nomeada explicitamente:

* Uma equipa é correspondida pelo seu **nome de apresentação exato** (não sensível a maiúsculas/minúsculas, em conformidade com Microsoft Graph; os espaços em branco circundantes no nome configurado são ignorados). Só essa equipa é processada - não há comportamento de prefixo nem de wildcard, por isso nomear uma entrada `EXT Service A` nunca afeta `EXT Service A Backup` ou semelhante.
* Os nomes de apresentação não têm garantia de serem únicos em Entra ID. Se várias equipas partilharem o nome configurado, o grupo de proprietários é aplicado a **todos** todas elas. Se nenhuma equipa corresponder, a entrada é reportada como *não encontrada* e omitida.

#### Seleção de equipas

Para cada `TeamName` configurado, o runbook executa uma consulta Graph `displayName eq '...'` de pesquisa e mantém apenas grupos Microsoft 365 que estão provisionados como uma **equipa**.

#### O que é alterado

* **Equipa (opcional, `IncludeTeamOwners`, ativado por predefinição):** os utilizadores do grupo de proprietários são adicionados como proprietários e membros do grupo M365 principal. A pertença à equipa é também o pré-requisito técnico para se tornar proprietário de um canal partilhado, pelo que este passo habilita o passo do canal.
* **Canais partilhados:** para cada canal partilhado alojado (`membershipType eq 'shared'`), cada utilizador do grupo de proprietários é garantido como um canal **proprietário**  - adicionado diretamente se estiver ausente, ou promovido se já for membro. Se uma adição direta como proprietário for rejeitada (por exemplo, atraso na replicação da associação), o runbook recorre a adicionar primeiro o utilizador como membro e depois promovê-lo.

#### Execução de teste

Selecione **Execução de teste?** para registar o que mudaria sem escrever nada. Cada execução apresenta, desde o início, as equipas que irá processar (com o respetivo grupo de proprietários) e quaisquer nomes de equipas configurados que não foram encontrados; numa execução de teste, as alterações são listadas como alterações planeadas.

#### Agendamento

Concebido para ser executado sem supervisão, numa agenda. Como a configuração está centralizada nas definições da organização e o runbook é apenas de adição e idempotente, um único agendamento recorrente mantém todas as equipas mapeadas e os respetivos canais partilhados em sincronização à medida que pessoas e canais entram e saem.

### Entrega do relatório

Cada execução escreve os respetivos resultados no separador Output Data do portal RealmJoin: um resumo, as alterações efetuadas (ou planeadas numa execução de teste), as equipas e os utilizadores omitidos com o motivo (equipa não encontrada, grupo de proprietários vazio, utilizadores convidados, alterações falhadas) e as atribuições de proprietários que já estavam em vigor. Cada tabela pode ser exportada para Excel aí.

Os ficheiros do relatório só são gerados quando é selecionado um método de entrega através da **Entrega do relatório** opção (e-mail e/ou hiperligação de transferência): um resumo por equipa e uma lista detalhada por alteração, como ficheiros CSV e/ou como um livro de trabalho do Excel. Com *Apenas dados de saída* selecionado, os resultados são lidos diretamente no separador Output Data. A entrega por e-mail e a geração de hiperligação de transferência são independentes e podem ser combinadas; quando ambas são selecionadas, as hiperligações de transferência também são incorporadas no e-mail.

Para a ligação de download, os ficheiros do relatório são carregados para o Azure Storage Account configurado nas `RJReport.StorageAccount.*` definições do Tenant, e são devolvidos links de download SAS com prazo limitado. O carregamento para o armazenamento autentica-se com a identidade gerida da Automation account; essa identidade precisa da **, atribuída diretamente na Storage Account.** função RBAC na Storage Account de destino (isto é uma atribuição de Azure RBAC, não uma permissão de aplicação do Graph).

Os agendamentos que foram guardados com as etiquetas de entrega anteriores (por exemplo *Relatório por e-mail*) mantêm a respetiva entrega. Quando esse agendamento é aberto para edição, a opção mostra *Apenas dados de saída* embora a entrega armazenada permaneça ativa; selecione novamente a entrega antes de guardar, para que a caixa de diálogo corresponda ao que o agendamento faz.

### Configuração relativa ao envio de e-mail

O envio do relatório por e-mail é opcional e só acontece quando *Enviar também o relatório por e-mail* ou *Enviar também por e-mail e ligação de download* é selecionado como entrega do relatório; nesse caso, é necessário um destinatário. O e-mail com a marca RealmJoin (enviado via `Send-RjRbReportEmail`) contém as estatísticas da execução e os ficheiros do relatório como anexos. O endereço do remetente é obtido a partir do `RJReport.EmailSender` definição do Tenant.

Este runbook envia e-mails usando a API Microsoft Graph. Para enviar e-mails via API Graph, é necessário configurar um endereço de e-mail existente na personalização do runbook.

Veja a [documentação das definições de relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obter detalhes sobre todas as definições disponíveis.

#### Branding do e-mail

O e-mail do relatório respeita as `RJReport.Branding.*` definições opcionais do Tenant:

* **Imagem do cabeçalho e do rodapé** - URLs HTTPS públicos, PNG/JPEG/GIF, máx. 200 KB cada
* **Link do rodapé** - destino da imagem de rodapé
* **Cor de destaque e do texto** - valores hexadecimais de 6 dígitos, por ex. `#0052cc`

Quando estas definições não estão configuradas, são usadas as imagens e cores predefinidas do RealmJoin. Uma imagem que não possa ser descarregada ou validada, ou um valor de cor inválido, nunca impede o e-mail do relatório - é usada em vez disso a predefinição correspondente.

Instruções de configuração e requisitos de imagem: [Branding do e-mail](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Localização

Organization → General → Sync Shared Channel Owners (Scheduled)

**Nome completo do runbook**

rjgit-org\_general\_sync-shared-channel-owners\_scheduled

### Detalhes

| Propriedade         | Valor                                                                                                              |
| ------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Versão              | 1.5.0                                                                                                              |
| Módulos necessários | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Agendável           | sim                                                                                                                |

### Permissões

#### Permissões de aplicativo

* **Tipo**: Microsoft Graph
  * Channel.ReadBasic.All
    * *Lista /teams/{id}/channels para encontrar os canais partilhados a processar*
  * ChannelMember.ReadWrite.All
    * *Lê os membros do canal e adiciona utilizadores ou promove-os para proprietário do canal partilhado*
  * Group.ReadWrite.All
    * *Lista equipas, lê os nomes dos grupos de proprietários e os proprietários dos grupos e adiciona os proprietários em falta da equipa através de /groups/{id}/owners/$ref*
  * GroupMember.ReadWrite.All
    * *Lê os membros transitivos do grupo de proprietários e adiciona primeiro os utilizadores como membros da equipa*
  * User.Read.All
    * *Lê as propriedades do utilizador membro (UPN, userType) através de transitiveMembers para filtrar convidados*
  * Mail.Send *(opcional — funcionalidade: Relatório por e-mail)*
    * *Envia o e-mail do relatório de sincronização através de Send-RjRbReportEmail quando a entrega por e-mail é selecionada*
  * Organization.Read.All *(opcional — funcionalidade: Relatório por e-mail)*
    * *Lê o nome de apresentação do Tenant para o email do relatório*

#### Notas de permissão

Azure Storage Account: função 'Reader and Data Access' para a identidade gerida da Automation Account na Storage Account de destino - o carregamento obtém as chaves da conta através de listKeys (só necessário para as opções de ligação de download)

### Parâmetros

#### TeamOwnerGroupMapping

Lista de nomes de equipas com o grupo de segurança cujos membros se tornam proprietários. Obtida da definição do Tenant SharedChannelOwners.Mapping.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | \[]                                                     |
| Tipo             | Objeto                                                  |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### IncludeTeamOwners

Também torna os membros do grupo proprietários e membros da própria equipa, o que é necessário para serem donos dos respetivos canais.

| Propriedade                | Valor                                     |
| -------------------------- | ----------------------------------------- |
| Obrigatório                | falso                                     |
| Valor padrão               | Verdadeiro                                |
| Tipo                       | Booleano                                  |
| Nome de exibição no portal | Torná-los também proprietários da equipa? |

#### WhatIfMode

Apenas regista o que mudaria sem escrever nada.

| Propriedade                | Valor              |
| -------------------------- | ------------------ |
| Obrigatório                | falso              |
| Valor padrão               | Falso              |
| Tipo                       | Booleano           |
| Nome de exibição no portal | Execução de teste? |

#### SendEmailReport

Envia o relatório para o endereço de e-mail do destinatário.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | Falso                                                   |
| Tipo             | Booleano                                                |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### EmailTo

Envie o relatório para estes endereços. Separe vários com vírgulas; cada destinatário recebe um e-mail separado.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               |                                                         |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Endereço(s) de e-mail do destinatário                   |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

#### EmailFrom

Endereço do remetente do e-mail do relatório. Obtido a partir da definição do Tenant RJReport.EmailSender.

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

#### BrandingHeaderImageUrl

Imagem do cabeçalho do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida a partir da definição do Tenant RJReport.Branding.HeaderImageUrl; o cabeçalho padrão do RealmJoin é usado quando está vazio.

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

#### BrandingFooterImageUrl

Imagem do rodapé do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida a partir da definição do Tenant RJReport.Branding.FooterImageUrl; o rodapé padrão do RealmJoin é usado quando está vazio.

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

#### BrandingFooterLink

Link por trás da imagem do rodapé do e-mail do relatório. Obtido a partir da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é usado quando está vazio.

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

#### BrandingAccentColor

Cor de destaque do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida a partir da definição do Tenant RJReport.Branding.AccentColor; o padrão do RealmJoin é usado quando está vazio ou inválido.

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

#### BrandingTextColor

Cor do texto do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida a partir da definição do Tenant RJReport.Branding.TextColor; o padrão do RealmJoin é usado quando está vazio ou inválido.

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

#### ReportFileFormat

Entregue o relatório em CSV, como uma pasta de trabalho do Excel, ou ambos.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               | CSV e XLSX                                              |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Formato do arquivo do relatório                         |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

**Opções do portal**

| Opção do portal | Valor        |
| --------------- | ------------ |
| CSV e XLSX      | CSV e XLSX   |
| Somente CSV     | Somente CSV  |
| Somente XLSX    | Somente XLSX |

#### CreateDownloadLink

Além disso, faça upload do relatório e retorne um link de download que expira após alguns dias.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | Falso                                                   |
| Tipo             | Booleano                                                |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ContainerName

Contêiner de armazenamento para o qual os arquivos do relatório são enviados. Definido por runbook.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | shared-channel-owners                                   |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ResourceGroupName

Grupo de recursos da Storage Account para uploads de relatórios. Obtido da configuração do Tenant RJReport.StorageAccount.ResourceGroup.

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

#### StorageAccountName

Storage Account para uploads de relatórios. Obtida da configuração do Tenant RJReport.StorageAccount.StorageAccountName.

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

#### SubscriptionId

ID da assinatura da Storage Account para uploads de relatórios. Obtido da configuração do Tenant RJReport.StorageAccount.SubscriptionId; quando vazio, é usada a assinatura na qual a identidade gerenciada entra.

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

#### LinkExpiryDays

Número de dias que um link de download permanece válido. Obtido da configuração do Tenant RJReport.StorageAccount.LinkExpiryDays.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | 6                                                       |
| Tipo             | Int32                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

[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/org/general/sync-shared-channel-owners_scheduled.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.
