SharePoint Online 命令行管理程序入门

若要开始使用 PowerShell 管理 SharePoint Online,需要安装 SharePoint Online Management Shell 并连接到 SharePoint Online。

通过下载并运行 SharePoint Online 命令行管理程序或从 PowerShell 库安装模块来安装 SharePoint Online 命令行管理程序。 该模块一经安装,即可使用。在需要更高版本中引入的功能之前,无需再次安装。 例如,你可能需要在 2018 年 10 月之后安装新版本的 TLS 1.2 协商。

首先,可以通过在 PowerShell 的管理模式下运行以下命令来检查是否已安装 SharePoint Online Management Shell:

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

如果操作系统使用的是 PowerShell 5 或更高版本,也可以通过在管理模式下运行以下命令来安装 SharePoint Online Management Shell:

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

如果系统上没有管理权限,则只能通过运行以下命令为当前用户安装 SharePoint Online Management Shell:

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

若要确保拥有所有可用的 cmdlet,应始终确保模块是最新的。 可以通过在管理模式下运行以下命令来更新 SharePoint Online Management Shell:

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

若要打开 SharePoint Online 命令行管理程序的命令提示符,请从“开始”屏幕中键入 sharepoint,然后单击“SharePoint Online 命令行管理程序”。

使用用户名和密码连接

  1. 在 SharePoint Online Management Shell 命令提示符下运行以下命令:

    Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com
    
  2. 当出现“Windows PowerShell 凭据请求”对话框提示时,键入 SharePoint 管理员帐户的密码。

若要为用户分配 SharePoint 管理员角色,请参阅 使用 PowerShell 为 Microsoft 365 用户帐户分配管理员角色或分配管理员角色

备注

如果在尝试连接或收到错误(例如“错误消息:无法连接到 SharePoint Online”)时遇到问题,可能需要使用新式身份验证。 请参阅以下示例:

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

使用多重身份验证 (MFA) 连接

  1. 在 SharePoint Online Management Shell 命令提示符下运行以下命令:

    Connect-SPOService -Url https://contoso-admin.sharepoint.com
    
  2. 当出现“Microsoft SharePoint Online 命令行管理程序”对话框提示时,键入 SharePoint 管理员帐户的帐户名和密码,然后单击“登录”。

  3. 按照“Microsoft SharePoint Online 命令行管理程序”对话框中的说明提供其他身份验证信息(如验证码),然后单击“登录”。

现在即可使用 SharePoint Online 命令。

备注

SharePoint Online Management Shell 模块和 SharePoint 客户端组件 SDK 之间存在一个已知问题,如果两者都安装在同一台计算机上,则该模块将无法加载。 如果遇到此问题,请卸载 SharePoint 客户端组件 SDK。