Guida introduttiva a SharePoint Online Management Shell

  • Articolo

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.

Prima di tutto è possibile verificare se è già stata installata SharePoint Online Management Shell 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 di 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, è sempre necessario assicurarsi 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.

Connettersi con un nome utente e password

  1. Eseguire il comando seguente al 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 a Microsoft 365 account utente con PowerShell.

Nota

Se si verificano problemi durante il tentativo di connessione o la ricezione di un errore, ad esempio "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 al 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 SharePoint Online Management Shell e SharePoint Client Components SDK in cui il modulo non verrà caricato se entrambi sono installati nello stesso computer. Se si verifica questo problema, disinstallare SharePoint Client Components SDK.