O PnP PowerShell é uma ferramenta poderosa para administradores de sistemas que trabalham com o SharePoint Online. Ele permite automatizar tarefas administrativas e de configuração que, de outra forma, exigiriam interação manual através da interface gráfica do SharePoint. Neste artigo, vamos explorar como instalar e utilizar o PnP PowerShell em um ambiente Windows.

O que é o PnP PowerShell?

O PnP PowerShell é um módulo do PowerShell que fornece cmdlets para interagir com o SharePoint Online. Ele é parte do projeto Patterns and Practices (PnP) da Microsoft, que visa fornecer exemplos e ferramentas para desenvolvedores e administradores que trabalham com o Microsoft 365.

Instalação do PnP PowerShell no Windows

Para começar a usar o PnP PowerShell, você precisa instalá-lo em sua máquina Windows. Siga os passos abaixo para realizar a instalação:

1. Abra o Windows PowerShell como Administrador. Você pode fazer isso clicando com o botão direito no menu Iniciar e selecionando "Windows PowerShell (Admin)".

2. Execute o seguinte comando para instalar o módulo PnP PowerShell:

   Install-Module -Name PnP.PowerShell -AllowClobber -Scope CurrentUser

O parâmetro -AllowClobber permite que o módulo sobrescreva quaisquer cmdlets existentes com o mesmo nome, e -Scope CurrentUser instala o módulo apenas para o usuário atual.

3. Se solicitado, confirme a instalação do NuGet provider e a confiança no repositório PSGallery.

Exemplo de Uso do PnP PowerShell

Depois de instalar o módulo, você pode começar a usá-lo para gerenciar o SharePoint Online. Aqui está um exemplo de como conectar-se a um site do SharePoint Online e listar todas as listas desse site:

1. Primeiro, conecte-se ao seu site do SharePoint Online:

   Connect-PnPOnline -Url https://seusite.sharepoint.com/sites/seusite -UseWebLogin

O parâmetro -UseWebLogin abrirá uma janela de login para que você possa autenticar-se com suas credenciais do SharePoint.

2. Depois de conectado, você pode listar todas as listas do site com o seguinte comando:

   Get-PnPList | Select-Object Title

Este comando recupera todas as listas do site e exibe apenas o título de cada uma.

Automatizando Tarefas com Scripts

Você pode criar scripts do PowerShell para automatizar tarefas repetitivas. Aqui está um exemplo de script que adiciona um novo item a uma lista do SharePoint:

# Conectar ao site do SharePoint

Connect-PnPOnline -Url https://seusite.sharepoint.com/sites/seusite -UseWebLogin



# Adicionar um novo item à lista "Tarefas"

Add-PnPListItem -List "Tarefas" -Values @{"Title"="Nova Tarefa"; "AssignedTo"="usuario@dominio.com"}

Salve este script em um arquivo com a extensão .ps1 e execute-o no PowerShell para adicionar itens à lista automaticamente.