Olá pessoal,
No artigo anterior, eu expliquei por que o SharePoint Online e o Explorador de Arquivos do Windows podem apresentar ordens diferentes para as mesmas pastas.
Agora neste vamos demonstrar como utilizar o PnP.PowerShell para preencher automaticamente uma coluna numérica e organizar arquivos e pastas no SharePoint. sem a necessidade de renomear os arquivos existentes.
1. Criando a coluna Ordem
Acesse a biblioteca de documentos no SharePoint Online.
Clique em Adicionar coluna, selecione Número e crie uma coluna chamada:
Ordem
Essa coluna armazenará o número encontrado no início do nome de cada arquivo ou pasta.
Por exemplo:
001 - CLIENTE A → Ordem: 102 - CLIENTE B → Ordem: 2100 - CLIENTE C → Ordem: 100
2. Instalando o PnP.PowerShell
Abra o PowerShell 7 e execute:
Install-Module PnP.PowerShell -Scope CurrentUser
O módulo permite administrar recursos do SharePoint Online por meio de comandos PowerShell.
3. Autenticando no SharePoint Online
Para utilizar a autenticação interativa, é necessário possuir um aplicativo registrado no Microsoft Entra ID, com as permissões adequadas.
A conexão utiliza:
Connect-PnPOnline ` -Url $SiteUrl ` -Interactive ` -ClientId $ClientId
Substitua o Client ID pelo identificador do aplicativo autorizado em seu ambiente.
4. Script para organizar arquivos e pastas
O exemplo abaixo percorre os arquivos e as subpastas diretamente dentro de uma pasta específica, identifica números no início dos nomes e atualiza a coluna Ordem.
Ele também verifica o valor existente para evitar atualizações desnecessárias.
Exemplo de script:
# ==========================================# SHAREPOINT - ORDENACAO NUMERICA# ==========================================$ErrorActionPreference = "Stop"Import-Module PnP.PowerShell# Configuracoes$SiteUrl = "https://seudominio.sharepoint.com/sites/MeuSite"$ClientId = "SEU-CLIENT-ID"$LibraryName = "Documentos"$FolderPath = "Shared Documents/CLIENTES"$ColumnName = "Ordem"# ConexaoConnect-PnPOnline ` -Url $SiteUrl ` -Interactive ` -ClientId $ClientId# Verificar coluna$field = Get-PnPField ` -List $LibraryName ` -Identity $ColumnName ` -ErrorAction SilentlyContinueif (-not $field) { throw "Crie primeiro a coluna numerica Ordem."}# Buscar arquivos e pastas$items = Get-PnPFolderItem ` -FolderSiteRelativeUrl $FolderPath ` -ItemType All$atualizados = 0$ignorados = 0foreach ($item in $items) { $nome = $item.Name if ($nome -match '^(\d+)') { $ordem = [long]$Matches[1] $listItem = Get-PnPProperty ` -ClientObject $item ` -Property ListItemAllFields $atual = $listItem[$ColumnName] if ($null -ne $atual -and [long]$atual -eq $ordem) { continue } Set-PnPListItem ` -List $LibraryName ` -Identity $listItem.Id ` -Values @{ $ColumnName = $ordem } ` -UpdateType SystemUpdate | Out-Null Write-Host "Atualizado: $nome -> $ordem" $atualizados++ } else { $ignorados++ }}Write-Host "Atualizados: $atualizados"Write-Host "Sem codigo inicial: $ignorados"Disconnect-PnPOnline
Atenção: ajuste o endereço do site, o Client ID, o nome da biblioteca e o caminho real da pasta. O caminho interno de uma biblioteca pode ser diferente do nome exibido na interface.
O exemplo é indicado para estruturas menores. Em bibliotecas com milhares de itens, é necessário considerar consultas apropriadas, limites de exibição, paginação, processamento em lotes e possíveis restrições de tempo.
5. Configurando a visualização
Depois de executar o script:
- Acesse a biblioteca no SharePoint.
- Abra o menu da visualização.
- Selecione Editar exibição atual.
- Em Classificar, selecione Ordem — Crescente.
- Opcionalmente, configure Nome — Crescente como segundo critério.
- Em Agrupar por, mantenha as opções como Nenhum.
- Na seção Colunas, desmarque Ordem caso queira ocultá-la.
- Salve a visualização.
O resultado será uma listagem organizada numericamente, sem exibir a coluna auxiliar.
6. Automatizando a execução
O script apresentado utiliza autenticação interativa, sendo adequado para execução manual.
Para automatizar o processo em um Windows Server, podemos utilizar o Agendador de Tarefas do Windows em conjunto com autenticação App-Only por certificado no Microsoft Entra ID.
A conexão passa a utilizar um certificado associado ao aplicativo:
Connect-PnPOnline ` -Url $SiteUrl ` -ClientId $ClientId ` -Tenant $Tenant ` -Thumbprint $Thumbprint
Dessa forma, o processo pode ser executado periodicamente sem solicitar login de um administrador, sendo recomendável utilizar permissões restritas ao site necessário, registrar logs e atualizar somente itens com valores ausentes ou incorretos.
Conclusão
Com o PnP.PowerShell, é possível automatizar o preenchimento da coluna Ordem e melhorar a organização de bibliotecas do SharePoint Online.
Essa abordagem é especialmente útil para empresas que utilizam códigos numéricos nos nomes de clientes, contratos, processos ou documentos.
O procedimento mantém os nomes originais e permite criar visualizações mais organizadas para os usuários.
Até a próxima!
