SharePoint Online: como organizar pastas e arquivos numericamente com PowerShell

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: 1
02 - CLIENTE B → Ordem: 2
100 - 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"
# Conexao
Connect-PnPOnline `
-Url $SiteUrl `
-Interactive `
-ClientId $ClientId
# Verificar coluna
$field = Get-PnPField `
-List $LibraryName `
-Identity $ColumnName `
-ErrorAction SilentlyContinue
if (-not $field) {
throw "Crie primeiro a coluna numerica Ordem."
}
# Buscar arquivos e pastas
$items = Get-PnPFolderItem `
-FolderSiteRelativeUrl $FolderPath `
-ItemType All
$atualizados = 0
$ignorados = 0
foreach ($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:

  1. Acesse a biblioteca no SharePoint.
  2. Abra o menu da visualização.
  3. Selecione Editar exibição atual.
  4. Em Classificar, selecione Ordem — Crescente.
  5. Opcionalmente, configure Nome — Crescente como segundo critério.
  6. Em Agrupar por, mantenha as opções como Nenhum.
  7. Na seção Colunas, desmarque Ordem caso queira ocultá-la.
  8. 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!

Deixe um comentário

Este site utiliza o Akismet para reduzir spam. Saiba como seus dados em comentários são processados.