LinkedIn PowerShell Status Documentation

Aplica-se a: ✔️ Windows 10/11 ✔️ Windows Server 2016/2019/2022

A ferramenta gera um relatório HTML interativo que facilita a visualização e gerenciamento das diferenças entre as pastas comparadas. O relatório inclui gráficos, estatísticas e uma tabela de arquivos com recursos de filtragem e marcação de progresso.

👇 Clique no botão abaixo para visualizar um exemplo de relatório de comparação entre "Documentos vs Backup" 👇

Acessar Demo
O demo mostra todas as funcionalidades do relatório, incluindo gráficos, estatísticas e tabela interativa

image

image

image

1. Metadados
2. Screenshots
3. Funcionalidades
4. Pré-requisitos
5. Como Usar
6. Configuração de Múltiplas Pastas
7. Parâmetros do Script
8. Tratamento de Erros e Feedback
9. Relatório HTML
10. Versionamento

• Comparação eficiente de dois diretórios
• Processamento paralelo para melhor desempenho em grandes estruturas de arquivos
• Relatório HTML interativo com gráficos, estatísticas e tabela de arquivos
• Controle de progresso visual em tempo real
• Suporte para caminhos longos
• Tratamento otimizado para grandes volumes de arquivos
• Rastreamento de tempo e estatísticas de processamento
• Sistema de checklist para acompanhamento de sincronização

• Paralelo: Utiliza múltiplos threads para melhor desempenho em sistemas modernos
• Sequencial: Compatível com ambientes mais restritos como PowerShell ISE

• Gráficos de distribuição por tamanho de arquivo
• Gráficos de extensões mais comuns
• Distribuição por subpastas
• Tabela completa dos arquivos com filtros e paginação
• Sistema de progresso para acompanhamento de sincronização
• Estatísticas detalhadas do resultado da comparação

• Windows 10/11 ou Windows Server 2016/2019/2022
• PowerShell 5.1 ou superior
• Permissões de leitura nas pastas a serem comparadas
• Navegador moderno para visualizar o relatório HTML (Chrome, Edge, Firefox)
• PowerShell 7+ para processamento paralelo (opcional, mas recomendado para melhor performance)

1. Baixe o script:

Download Script Compare-FolderStructures.ps1

3. Abra o script em um editor de texto como Notepad++ ou VSCode
4. Localize a seção de configuração no final do script:

# Configurações de exemplo (podem ser alteradas conforme necessário)
$outputDir = "C:\temp\COMPARAÇÕES" # Pasta onde serão salvos os relatórios
# Definir os pares de pastas para comparação
$folderPairs = @(
 # Par 1: Documentos Rede vs Documentos Local
 @{
 Folder1 = "\\servidor\compartilhamento\Documentos"
 Folder2 = "D:\Backup\Documentos"
 }
)
# Executar a comparação com geração automática de nomes
Compare-FolderPairs -FolderPairs $folderPairs -OutputDir $outputDir

4. Modifique as variáveis:
   • $outputDir: Pasta onde os relatórios HTML serão salvos
   • $folderPairs: Caminhos das pastas que deseja comparar
     • Folder1: Pasta de origem (arquivos que serão verificados)
     • Folder2: Pasta de destino (onde será procurado se o arquivo existe)

Método 1: PowerShell ISE ou Console

1. Abra o PowerShell ISE ou o Console do PowerShell
2. Navegue até a pasta do script:

   cd "C:\Caminho\Para\Pasta\Do\Script"

3. Execute o script:

   .\Compare-FolderStructures.ps1

Método 2: Clique com botão direito

1. Clique com o botão direito no script
2. Selecione "Executar com PowerShell"

• O script mostrará o progresso em tempo real no console
• Ao concluir, um relatório HTML será gerado na pasta de saída configurada
• O relatório será aberto automaticamente no navegador padrão

Para comparar múltiplos pares de pastas em uma única execução, modifique a configuração $folderPairs adicionando mais itens ao array:

# Definir os pares de pastas para comparação
$folderPairs = @(
 # Par 1: Documentos Rede vs Documentos Local
 @{
 Folder1 = "\\servidor\compartilhamento\Documentos"
 Folder2 = "D:\Backup\Documentos"
 },
 # Par 2: Imagens Rede vs Imagens Local
 @{
 Folder1 = "\\servidor\compartilhamento\Imagens"
 Folder2 = "D:\Backup\Imagens"
 },
 # Par 3: Projetos Rede vs Projetos Local
 @{
 Folder1 = "\\servidor\compartilhamento\Projetos"
 Folder2 = "D:\Backup\Projetos" 
 }
)

Cada par de pastas gerará um relatório HTML separado na pasta de saída configurada.

O script fornece feedback visual em tempo real com cores diferentes:

• 🟦 Azul/Ciano: Informações do processo
• 🟩 Verde: Operações concluídas com sucesso
• 🟨 Amarelo: Avisos e alertas não críticos
• 🟥 Vermelho: Erros críticos que impediram a execução

Erros comuns que são tratados automaticamente:

• Pastas inacessíveis ou inexistentes
• Problemas de permissão em arquivos
• Caminhos muito longos (quando HandleLongPaths é ativado)
• Limitações do PowerShell ISE (modo paralelo é desativado automaticamente)

O relatório HTML gerado inclui:

1. Cabeçalho com Informações Gerais

   • Pastas comparadas (origem e destino)
   • Data e hora da comparação
   • Estatísticas gerais (arquivos analisados, arquivos ausentes, tamanho total)

2. Resumo da Análise

   • Total de arquivos analisados
   • Arquivos ausentes na pasta de destino
   • Tamanho total dos arquivos ausentes

3. Visualizações Gráficas

   • Distribuição por tamanho de arquivo
   • Top 10 extensões mais comuns
   • Top 5 subpastas com mais arquivos ausentes

4. Sistema de Progresso de Sincronização

   • Barra de progresso visual
   • Contadores de arquivos pendentes e concluídos
   • Sistema de checklist para marcar arquivos já processados

5. Tabela Detalhada

   • Lista completa de todos os arquivos ausentes
   • Filtros e ordenação por qualquer coluna
   • Paginação para melhor navegação
   • Botões para copiar caminhos

• Versão: 1.0.0
• Última atualização: 07/03/2025