Connect PowerShell to SharePoint Online

Install the SharePoint Online Management Shell and connect to SharePoint Online.

Source: https://technet.microsoft.com/en-us/library/fp161372.aspx

Applies to: SharePoint Online

Topic Last Modified: 2017-09-13

Summary: Install the SharePoint Online Management Shell and connect to SharePoint Online.

Before you get started using PowerShell to manage SharePoint Online, make sure that the SharePoint Online Management Shell is installed and you have connected to SharePoint Online.

Install the SharePoint Online Management Shell by downloading and running the SharePoint Online Management Shell. You only need to do this once for each computer from which you are running SharePoint Online PowerShell commands.

To open the SharePoint Online Management Shell command prompt, from the Start screen, type sharepoint, and then click SharePoint Online Management Shell.

To connect with a user name and password

1. Fill in the values for the $adminUPN and $orgName variables (replacing all the text between the quotes, including the < and > characters), and then run the following commands at the SharePoint Online Management Shell command prompt:
   $adminUPN="<the full email address of a SharePoint administrator account, example: jdoe@contosotoycompany.onmicrosoft.com>"
   $orgName="<name of your Office 365 organization, example: contosotoycompany>"
   $userCredential = Get-Credential -UserName $adminUPN -Message "Type the password."
   Connect-SPOService -Url https://$orgName-admin.sharepoint.com -Credential $userCredential
   

2. When prompted with the Windows PowerShell credential request dialog box, type the password for the SharePoint Online SharePoint administrator account.

To make a user account a SharePoint administrator, see Assign admin roles in Office 365 for business or Assign roles to user accounts with Office 365 PowerShell.

To connect with multifactor authentication (MFA)

1. Fill in the value for the $orgName variable (replacing all the text between the quotes, including the < and > characters), and then run the following commands at the SharePoint Online Management Shell command prompt:
   $orgName="<name of your Office 365 organization, example: contosotoycompany>"
   Connect-SPOService -Url https://$orgName-admin.sharepoint.com
   

2. When prompted with the Microsoft SharePoint Online Management Shell dialog box, type the account name and password for a SharePoint administrator account, and then click Sign in.
3. Follow the instructions in the Microsoft SharePoint Online Management Shell dialog box to provide the additional authentication information, such as a verification code, and then click Sign in.

You are now ready to begin executing SharePoint Online commands.

Share on Google Plus

About Tom DeMeulenaere

Highly accomplished information technology professional with extensive knowledge in System Center Configuration Manager, Windows Server, SharePoint, and Office 365.