> 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).
# Aprovação automática agendada de atualizações de drivers
Aprovar automaticamente novas atualizações de drivers nas políticas de atualização de drivers do Intune
{% hint style="info" %}
Este é um Runbook agendado. Foi concebido para ser executado segundo um agendamento recorrente, em vez de ser acionado para um único objeto. Consulte [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 pendentes de controladores em uma ou mais políticas de atualização de controladores do Intune. Ele pode filtrar atualizações de controladores por padrão de nome de exibição, classe do controlador ou fabricante. Notificações opcionais por email podem ser enviadas após a conclusão das operações de aprovação. O email de notificação inclui arquivos de relatório CSV e/ou Excel (xlsx) listando cada ação de aprovação de controlador (política, controlador, versão, fabricante, classe do controlador, data de lançamento e resultado). Os arquivos de relatório também podem ser enviados para um Azure Storage Account, retornando links de download com prazo limitado. O parâmetro ReportFileFormat controla quais formatos de arquivo são gerados e entregues (somente CSV, CSV e XLSX, ou somente XLSX). Quando o anexo CSV excede o limite de tamanho do email e "CSV & XLSX" é selecionado, o email faz fallback para a própria pasta de trabalho do Excel.
### Configuração relativa ao envio de e-mails
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 `RJReport.EmailSender` configuração do Tenant.
Este Runbook envia e-mails usando a API do Microsoft Graph. Para enviar e-mails através da API do Microsoft Graph, é necessário configurar um endereço de e-mail existente na personalização do runbook.
Consulte a [documentação de Configurações de Relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para detalhes sobre todas as definições disponíveis.
#### Branding do e-mail
O e-mail do relatório respeita a configuração opcional `RJReport.Branding.*` do Tenant:
* **Imagem de cabeçalho e rodapé** – URLs públicas HTTPS, PNG/JPEG/GIF, máx. 200 KB cada
* **Ligação do rodapé** – destino da imagem de rodapé
* **Cor de acento e texto** – valores hexadecimais de 6 dígitos, por exemplo `#0052cc`
Quando estas definições não estão configuradas, são usados os gráficos e cores padrão 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 – em vez disso, é usado o padrã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
Organização → Dispositivos → Aprovação Automática de Atualizações de Controlador (Agendada)
**Nome completo do Runbook**
rjgit-org\_devices\_auto-approve-driver-updates\_scheduled
### Detalhes
| Propriedade | Valor |
| ------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Versão | 1.3.0 |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.9)
Microsoft.Graph.Authentication (>= 2.39.0)
Az.Accounts (>= 5.5.2)
|
| Agendável | sim |
### Notas
Pré-requisitos:
* Acesso à API BETA do Microsoft Graph (os endpoints de atualização de controladores 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 controladores seriam aprovados
* Aprovar automaticamente todos os controladores: execute sem quaisquer parâmetros de filtro
* Aprovar fabricantes específicos: use DriverManufacturer para direcionar fornecedores como "Intel" ou "AMD"
* Direcionar políticas específicas: use PolicyNames ou PolicyIds para limitar o escopo primeiro às políticas de teste
* Monitorar aprovações: configure EmailTo para receber relatórios detalhados após cada execução
Interações dos parâmetros:
* Se nenhum filtro de política for especificado, TODAS as políticas de atualização de controladores são processadas
* Se nenhum filtro de controlador for especificado, TODOS os controladores 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 fazer alterações - útil para testar filtros
### Permissões
#### Permissões da aplicação
* **Tipo**: Microsoft Graph
* DeviceManagementConfiguration.ReadWrite.All
* *Lê perfis de atualização de controladores do Windows e seus inventários e aprova controladores pendentes*
* Mail.Send *(opcional — funcionalidade: relatório por e-mail)*
* *Envia o email do relatório de aprovação por meio 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 controladores para limitar o escopo da 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 predefinido | |
| Tipo | Texto |
| Nome de exibição no portal | Nomes das Políticas de Atualização de Controladores |
#### PolicyIds
(Opcional) Lista separada por vírgulas de IDs das políticas de atualização de controladores para limitar o escopo da 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 predefinido | |
| Tipo | Texto |
| Nome de exibição no portal | IDs das Políticas de Atualização de Controladores |
#### DriverDisplayNamePattern
(Opcional) Filtre atualizações de controladores pelo padrão do nome de exibição (suporta curingas). Apenas os controladores correspondentes serão aprovados.
| Propriedade | Valor |
| -------------------------- | ----------------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Texto |
| Nome de exibição no portal | Filtro de Nome do Controlador |
#### DriverClass
(Opcional) Filtre por IDs de classe do controlador (separados por vírgulas). Exemplo: "Bluetooth,Networking,Firmware" para classes específicas de controladores.
| Propriedade | Valor |
| -------------------------- | ------------------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Texto |
| Nome de exibição no portal | Filtro de Classe do Controlador |
#### DriverManufacturer
(Opcional) Filtre pelo nome do fabricante do controlador. Apenas controladores do fabricante especificado serão aprovados.
| Propriedade | Valor |
| -------------------------- | -------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Texto |
| Nome de exibição no portal | Filtro de Fabricante |
#### MaximumDriverAge
(Opcional) Idade máxima em dias para que os controladores sejam aprovados. Apenas controladores lançados nos últimos X dias serão aprovados. Exemplo: 30 para aprovar apenas controladores lançados nos últimos 30 dias.
| Propriedade | Valor |
| -------------------------- | ---------------------------------- |
| Obrigatório | falso |
| Valor predefinido | 0 |
| Tipo | Int32 |
| Nome de exibição no portal | Idade Máxima do Controlador (Dias) |
#### OnlyNeedsReview
Quando ativado (padrão), apenas controladores com o status "needsReview" são aprovados. Controladores com o status "suspended" ou "declined" são ignorados. Desative para aprovar novamente também os controladores suspensos ou recusados.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição no portal | Aprovar apenas controladores "Needs Review" |
#### WhatIf
(Opcional) Quando ativado, simula aprovações de controladores sem fazer alterações reais. Mostra quais controladores seriam aprovados e envia um relatório para EmailTo, se configurado.
| Propriedade | Valor |
| -------------------------- | -------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Parâmetro de alternância |
| Nome de exibição no portal | Modo What-If (Execução Simulada) |
#### ReportFileFormat
Controla quais formatos de ficheiro do relatório são gerados e entregues: "Apenas CSV", "CSV e XLSX" (predefinição) ou "Apenas XLSX".
| Propriedade | Valor |
| -------------------------- | ------------------------------- |
| Obrigatório | falso |
| Valor predefinido | CSV e XLSX |
| Tipo | Texto |
| Nome de exibição no portal | Formato do arquivo do relatório |
**Opções do portal**
| Opção do portal | Valor |
| --------------- | ----- |
| CSV e XLSX | |
| Somente CSV | |
| Somente XLSX | |
#### CreateDownloadLink
Se ativado, os ficheiros do relatório são carregados para uma Storage Account do Azure e são devolvidos links de download com validade limitada. Desativado por predefinição.
| Propriedade | Valor |
| -------------------------- | -------------------------------------------------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | 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 predefinido | auto-approve-driver-updates |
| Tipo | Texto |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ResourceGroupName
Grupo de recursos que contém a Storage Account. Obtido das definições do Tenant RJReport.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Texto |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### StorageAccountName
Nome da Storage Account usado para o carregamento. Obtido das definições do Tenant RJReport.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Texto |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### LinkExpiryDays
Número de dias até o link de download gerado expirar. Obtido das definições do Tenant RJReport.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | 6 |
| Tipo | Int32 |
| Oculto no portal | sim (predefinido através da 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 predefinido | |
| Tipo | Texto |
| Oculto no portal | sim (predefinido através da 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 vazio, é usada a imagem de cabeçalho padrão do RealmJoin.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Texto |
| Oculto no portal | sim (predefinido através da 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 vazio, é usada a imagem de rodapé padrão do RealmJoin.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Texto |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingFooterLink
URL opcional para a qual a imagem de rodapé aponta. Obtida da configuração do Tenant RJReport.Branding.FooterLink. Quando vazio, é usada a ligação padrão ().
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Texto |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingAccentColor
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Texto |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingTextColor
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Texto |
| Oculto no portal | sim (predefinido através da 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 predefinido | |
| Tipo | Texto |
| 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=&goal=
```
`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.