> 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/org/devices/auto-approve-driver-updates_scheduled.md).

# Aprovar automaticamente atualizações de drivers agendado

{% 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. Veja [Agendamento](/pt/automacao/runbooks/scheduling.md) para detalhes sobre como configurar os agendamentos do runbook.
{% endhint %}

### Descrição

Este runbook agendado aprova automaticamente atualizações de drivers pendentes em uma ou mais políticas de atualização de drivers do Intune. Pode filtrar atualizações de drivers por padrão do nome de exibição, classe do driver ou fabricante. Podem ser enviadas notificações opcionais por email após a conclusão das operações de aprovação. O email de notificação inclui ficheiros de relatório CSV e/ou Excel (xlsx) que listam todas as ações de aprovação de drivers (política, driver, versão, fabricante, classe do driver, data de lançamento e resultado). Os ficheiros de relatório também podem ser carregados para um Azure Storage Account, devolvendo links de download com tempo limitado. O parâmetro ReportFileFormat controla quais formatos de ficheiro são gerados e entregues (apenas CSV, CSV e XLSX, ou apenas XLSX). Quando o anexo CSV excede o limite de tamanho do email e "CSV & XLSX" é selecionado, o email reverte para apenas o livro de trabalho do Excel.

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

O envio de um relatório por e-mail é opcional e só acontece quando um destinatário (`EmailTo`) é fornecido. O endereço do remetente é obtido da configuração de tenant `RJReport.EmailSender` .

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

Consulte a [documentação das Configurações de Relatório RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para detalhes.

#### Branding do e-mail

O e-mail do relatório respeita as configurações opcionais `RJReport.Branding.*` do tenant: uma imagem de cabeçalho personalizada, uma imagem de rodapé personalizada (URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada), um link de rodapé personalizado e cores personalizadas de destaque e de texto (valores hexadecimais de 6 dígitos, por ex. `#0052cc`). Quando essas configurações não estão definidas, são usadas as imagens e cores padrão do RealmJoin. Uma imagem de branding que não possa ser transferida por download ou validada, ou um valor de cor que não seja uma cor hex válida, nunca impede o e-mail do relatório - em vez disso, é usado o padrão correspondente.

Consulte a [documentação das Configurações de Relatório RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para detalhes de configuração.

### Localização

Organização → Dispositivos → Aprovar automaticamente atualizações de drivers (Agendado)

**Nome completo do runbook**

rjgit-org\_devices\_auto-approve-driver-updates\_scheduled

### Detalhes

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

### Notas

Pré-requisitos:

* Acesso à API BETA do Microsoft Graph (os endpoints de atualização de drivers estão em beta)
* Definição RJReport.EmailSender configurada (se forem usadas notificações por email)

Casos de uso comuns:

* Teste primeiro os filtros: use o parâmetro WhatIf para pré-visualizar quais drivers seriam aprovados
* Aprovar automaticamente todos os drivers: execute sem quaisquer parâmetros de filtro
* Aprovar fabricantes específicos: use DriverManufacturer para direcionar fornecedores como "Intel" ou "AMD"
* Direcione políticas específicas: use PolicyNames ou PolicyIds para restringir primeiro às políticas de teste
* Monitorize aprovações: configure EmailTo para receber relatórios detalhados após cada execução

Interações de parâmetros:

* Se nenhum filtro de política for especificado, TODAS as políticas de atualização de drivers são processadas
* Se nenhum filtro de driver for especificado, TODOS os drivers pendentes nas políticas selecionadas são aprovados
* PolicyNames e PolicyIds podem ser combinados - ambos os filtros são aplicados de forma independente
* As notificações por email exigem a definição RJReport.EmailSender e Connect-RjRbGraph
* O modo WhatIf simula aprovações sem efetuar alterações - útil para testar filtros

### Permissões

#### Permissões de aplicação

* **Tipo**: Microsoft Graph
  * DeviceManagementConfiguration.ReadWrite.All
    * *Lê os perfis de atualização de drivers do Windows e os respetivos inventários e aprova os drivers pendentes*
  * Mail.Send *(opcional — funcionalidade: relatório por e-mail)*
    * *Envia o email do relatório de aprovação através de Send-RjReportEmail quando EmailTo está configurado*
  * Organization.Read.All
    * *Lê /organization para o nome de exibição do Tenant usado no email do relatório*

### Parâmetros

#### PolicyNames

(Opcional) Lista separada por vírgulas de nomes de políticas de atualização de drivers para restringir a aprovação (por exemplo, "Policy1, Policy2, Policy3"). Se não for especificado, todas as políticas são processadas.

| Propriedade                | Valor                                         |
| -------------------------- | --------------------------------------------- |
| Obrigatório                | falso                                         |
| Valor padrão               |                                               |
| Tipo                       | String                                        |
| Nome de exibição no portal | Nomes das políticas de atualização de drivers |

#### PolicyIds

(Opcional) Lista separada por vírgulas de IDs de políticas de atualização de drivers para restringir a aprovação (por exemplo, "id1, id2, id3"). Se não for especificado, todas as políticas são processadas.

| Propriedade                | Valor                                       |
| -------------------------- | ------------------------------------------- |
| Obrigatório                | falso                                       |
| Valor padrão               |                                             |
| Tipo                       | String                                      |
| Nome de exibição no portal | IDs das políticas de atualização de drivers |

#### DriverDisplayNamePattern

(Opcional) Filtre as atualizações de drivers por padrão do nome de exibição (suporta caracteres curinga). Apenas os drivers correspondentes serão aprovados.

| Propriedade                | Valor                    |
| -------------------------- | ------------------------ |
| Obrigatório                | falso                    |
| Valor padrão               |                          |
| Tipo                       | String                   |
| Nome de exibição no portal | Filtro de nome do driver |

#### DriverClass

(Opcional) Filtre por IDs de classe de driver (separados por vírgulas). Exemplo: "Bluetooth,Networking,Firmware" para classes de driver específicas.

| Propriedade                | Valor                      |
| -------------------------- | -------------------------- |
| Obrigatório                | falso                      |
| Valor padrão               |                            |
| Tipo                       | String                     |
| Nome de exibição no portal | Filtro de classe de driver |

#### DriverManufacturer

(Opcional) Filtre pelo nome do fabricante do driver. Apenas os drivers do fabricante especificado serão aprovados.

| Propriedade                | Valor                |
| -------------------------- | -------------------- |
| Obrigatório                | falso                |
| Valor padrão               |                      |
| Tipo                       | String               |
| Nome de exibição no portal | Filtro de fabricante |

#### MaximumDriverAge

(Opcional) Idade máxima em dias para os drivers serem aprovados. Apenas os drivers lançados nos últimos X dias serão aprovados. Exemplo: 30 para aprovar apenas drivers lançados nos últimos 30 dias.

| Propriedade                | Valor                         |
| -------------------------- | ----------------------------- |
| Obrigatório                | falso                         |
| Valor padrão               | 0                             |
| Tipo                       | Int32                         |
| Nome de exibição no portal | Idade máxima do driver (dias) |

#### OnlyNeedsReview

Quando ativado (predefinição), apenas os drivers com o estado "needsReview" são aprovados. Os drivers com o estado "suspended" ou "declined" são ignorados. Desative para também voltar a aprovar drivers suspensos ou recusados.

| Propriedade                | Valor                                 |
| -------------------------- | ------------------------------------- |
| Obrigatório                | falso                                 |
| Valor padrão               | Verdadeiro                            |
| Tipo                       | Booleano                              |
| Nome de exibição no portal | Aprovar apenas drivers 'Needs Review' |

#### WhatIf

(Opcional) Quando ativado, simula aprovações de drivers sem efetuar alterações reais. Mostra quais drivers seriam aprovados e envia um relatório para EmailTo, se configurado.

| Propriedade                | Valor                            |
| -------------------------- | -------------------------------- |
| Obrigatório                | falso                            |
| Valor padrão               | Falso                            |
| Tipo                       | SwitchParameter                  |
| Nome de exibição no portal | Modo What-If (execução simulada) |

#### ReportFileFormat

Controla quais formatos de ficheiro de relatório são gerados e entregues: "apenas CSV", "CSV & XLSX" (predefinição) ou "apenas XLSX".

| Propriedade                | Valor                            |
| -------------------------- | -------------------------------- |
| Obrigatório                | falso                            |
| Valor padrão               | CSV & XLSX                       |
| Tipo                       | String                           |
| Nome de exibição no portal | Formato do ficheiro de relatório |

**Opções do portal**

| Opção do portal | Valor |
| --------------- | ----- |
| CSV & XLSX      |       |
| Apenas CSV      |       |
| Apenas XLSX     |       |

#### CreateDownloadLink

Se ativado, os ficheiros de relatório são carregados para uma Azure Storage Account e são devolvidos links de download com validade limitada. Desativado por predefinição.

| Propriedade                | Valor                                                                            |
| -------------------------- | -------------------------------------------------------------------------------- |
| Obrigatório                | falso                                                                            |
| Valor padrão               | Falso                                                                            |
| Tipo                       | Booleano                                                                         |
| Nome de exibição no portal | Criar um link de download do ficheiro (carregar relatório para o armazenamento)? |

**Opções do portal**

| Opção do portal                                           | Valor      |
| --------------------------------------------------------- | ---------- |
| Sim - carregar o relatório e devolver um link de download | verdadeiro |
| Não - não criar um link de download                       | falso      |

#### ContainerName

Nome do contentor de armazenamento usado para o carregamento. Configurado por runbook (não é uma definição global do RJReport).

| Propriedade      | Valor                                           |
| ---------------- | ----------------------------------------------- |
| Obrigatório      | falso                                           |
| Valor padrão     | auto-approve-driver-updates                     |
| Tipo             | String                                          |
| Oculto no portal | sim (predefinido via personalização do runbook) |

#### ResourceGroupName

Grupo de recursos que contém a storage account. Obtido a partir das definições do Tenant do RJReport.

| Propriedade      | Valor                                           |
| ---------------- | ----------------------------------------------- |
| Obrigatório      | falso                                           |
| Valor padrão     |                                                 |
| Tipo             | String                                          |
| Oculto no portal | sim (predefinido via personalização do runbook) |

#### StorageAccountName

Nome da Storage Account usado para o carregamento. Obtido a partir das definições do Tenant do RJReport.

| Propriedade      | Valor                                           |
| ---------------- | ----------------------------------------------- |
| Obrigatório      | falso                                           |
| Valor padrão     |                                                 |
| Tipo             | String                                          |
| Oculto no portal | sim (predefinido via personalização do runbook) |

#### LinkExpiryDays

Número de dias até o link de download gerado expirar. Obtido a partir das definições do Tenant do RJReport.

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

#### EmailFrom

Endereço de email do remetente para notificações. Este parâmetro é suportado por uma definição e não deve ser modificado diretamente.

| Propriedade      | Valor                                           |
| ---------------- | ----------------------------------------------- |
| Obrigatório      | falso                                           |
| Valor padrão     |                                                 |
| Tipo             | String                                          |
| Oculto no portal | sim (predefinido via personalização do runbook) |

#### BrandingHeaderImageUrl

URL HTTPS pública opcional de uma imagem de cabeçalho personalizada (PNG/JPEG/GIF, máx. 200 KB) para o e-mail do relatório. Obtida da configuração do tenant RJReport.Branding.HeaderImageUrl. Quando vazia, é usada a imagem padrão de cabeçalho do RealmJoin.

| Propriedade      | Valor                                           |
| ---------------- | ----------------------------------------------- |
| Obrigatório      | falso                                           |
| Valor padrão     |                                                 |
| Tipo             | String                                          |
| Oculto no portal | sim (predefinido via personalização do runbook) |

#### BrandingFooterImageUrl

URL HTTPS pública opcional de uma imagem de rodapé personalizada (PNG/JPEG/GIF, máx. 200 KB) para o e-mail do relatório. Obtida da configuração do tenant RJReport.Branding.FooterImageUrl. Quando vazia, é usada a imagem padrão de rodapé do RealmJoin.

| Propriedade      | Valor                                           |
| ---------------- | ----------------------------------------------- |
| Obrigatório      | falso                                           |
| Valor padrão     |                                                 |
| Tipo             | String                                          |
| Oculto no portal | sim (predefinido via personalização do runbook) |

#### BrandingFooterLink

URL opcional para onde a imagem de rodapé aponta. Obtida da configuração do tenant RJReport.Branding.FooterLink. Quando vazia, é usado o link padrão (<https://www.realmjoin.com>).

| Propriedade      | Valor                                           |
| ---------------- | ----------------------------------------------- |
| Obrigatório      | falso                                           |
| Valor padrão     |                                                 |
| Tipo             | String                                          |
| Oculto no portal | sim (predefinido via personalização do runbook) |

#### BrandingAccentColor

| Propriedade      | Valor                                           |
| ---------------- | ----------------------------------------------- |
| Obrigatório      | falso                                           |
| Valor padrão     |                                                 |
| Tipo             | String                                          |
| Oculto no portal | sim (predefinido via personalização do runbook) |

#### BrandingTextColor

| Propriedade      | Valor                                           |
| ---------------- | ----------------------------------------------- |
| Obrigatório      | falso                                           |
| Valor padrão     |                                                 |
| Tipo             | String                                          |
| Oculto no portal | sim (predefinido via personalização do runbook) |

#### EmailTo

(Opcional) Endereço de email do destinatário para notificações de aprovação. Se não for especificado, nenhum email é enviado.

| Propriedade                | Valor                       |
| -------------------------- | --------------------------- |
| Obrigatório                | falso                       |
| Valor padrão               |                             |
| Tipo                       | String                      |
| Nome de exibição no portal | Destinatário da notificação |

[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/org/devices/auto-approve-driver-updates_scheduled.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.