Guida introduttiva a SharePoint Online Management Shell

Per iniziare a usare PowerShell per gestire SharePoint Online, è necessario installare SharePoint Online Management Shell e connettersi a SharePoint Online.

Installare SharePoint Online Management Shell scaricando ed eseguendo SharePoint Online Management Shell o installando il modulo dalla PowerShell Gallery. Dopo l'installazione, il modulo è disponibile per l'uso e non è necessario installarlo di nuovo finché non sono necessarie caratteristiche introdotte in una versione più recente. Ad esempio, potrebbe essere necessario installare una nuova versione per la negoziazione TLS 1.2 dopo ottobre 2018.

Per prima cosa, verificare se SharePoint Online Management Shell è già installato eseguendo il comando seguente in modalità amministrativa in PowerShell:

Get-Module -Name Microsoft.Online.SharePoint.PowerShell -ListAvailable | Select Name,Version

Se il sistema operativo usa Windows PowerShell 5, è anche possibile installare SharePoint Online Management Shell eseguendo il comando seguente in modalità amministrativa:

Install-Module -Name Microsoft.Online.SharePoint.PowerShell

Se non si dispone dei privilegi amministrativi nel sistema, è possibile installare SharePoint Online Management Shell solo per l'utente corrente eseguendo il comando seguente:

Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Scope CurrentUser

Per assicurarsi di avere tutti i cmdlet disponibili, è consigliabile verificare sempre che il modulo sia aggiornato. È possibile aggiornare SharePoint Online Management Shell eseguendo il comando seguente in modalità amministrativa:

Update-Module -Name Microsoft.Online.SharePoint.PowerShell

Per aprire il prompt dei comandi di SharePoint Online Management Shell, dalla schermata Start digitare sharepoint, quindi fare clic su SharePoint Online Management Shell.

Nota

Per eseguire i comandi di SharePoint Online PowerShell in una console di Windows PowerShell 7, è necessario importare il modulo di SharePoint usando il parametro -UseWindowsPowerShell.

Import-Module Microsoft.Online.SharePoint.PowerShell -UseWindowsPowerShell

Connettersi con un nome utente e password

  1. Eseguire il comando seguente dal prompt dei comandi di SharePoint Online Management Shell:

    Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com
    
  2. Quando si visualizza la finestra di dialogo relativa alla richiesta di credenziali per Windows PowerShell, digitare la password dell'account di amministratore di SharePoint.

Per assegnare a un utente il ruolo di amministratore di SharePoint, vedere Assegnare ruoli di amministratore o Assegnare ruoli di amministratore agli account utente di Microsoft 365 con PowerShell.

Nota

Se si verificano problemi durante il tentativo di connessione o si riceve un messaggio di errore come "Messaggio di errore: Impossibile connettersi a SharePoint Online", potrebbe essere necessario usare l'autenticazione moderna. Ad esempio:

Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations

Per connettersi con l'autenticazione a più fattori

  1. Eseguire il comando seguente dal prompt dei comandi di SharePoint Online Management Shell:

    Connect-SPOService -Url https://contoso-admin.sharepoint.com
    
  2. Quando richiesto nella finestra di dialogo Microsoft SharePoint Online Management Shell, digitare il nome e la password di un account amministratore di SharePoint, quindi fare clic su Accedi.

  3. Seguire le istruzioni riportate nella finestra di dialogo Microsoft SharePoint Online Management Shell al fine di fornire altre informazioni di autenticazione, ad esempio, un codice di verifica, quindi fare clic su Accedi.

A questo punto è possibile usare i comandi di SharePoint Online.

Nota

Esiste un problema noto tra il modulo di SharePoint Online Management Shell e l'SDK dei componenti client di SharePoint per cui il modulo non viene caricato se entrambi sono installati nello stesso computer. Se si verifica questo problema, disinstallare l'SDK dei componenti client SharePoint.