SharePoint Online 命令行管理程序入门

  • 项目

若要开始使用 PowerShell 管理 SharePoint Online，需要安装 SharePoint Online 命令行管理程序并连接到 SharePoint Online。

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

首先，可以通过在 PowerShell 中的管理模式下运行以下命令来检查是否已安装 SharePoint Online 命令行管理程序：

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

如果操作系统使用 Windows PowerShell 5，还可以通过在管理模式下运行以下命令来安装 SharePoint Online 命令行管理程序：

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

如果对系统没有管理权限，可以通过运行以下命令，仅为当前用户安装 SharePoint Online 命令行管理程序：

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

若要确保所有可用的 cmdlet，应始终确保模块是最新的。 可以通过在管理模式下运行以下命令来更新 SharePoint Online 命令行管理程序：

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

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

使用用户名和密码连接

  1. 在 SharePoint Online 命令行管理程序命令提示符处运行以下命令：

    Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com

  2. 当出现“Windows PowerShell 凭据请求”对话框提示时，键入 SharePoint 管理员帐户的密码。

若要向用户分配 SharePoint 管理员角色，请参阅使用 PowerShell 为 365 个用户帐户分配管理员角色或将管理员角色分配给 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 命令行管理程序命令提示符处运行以下命令：

    Connect-SPOService -Url https://contoso-admin.sharepoint.com

  2. 当出现“Microsoft SharePoint Online 命令行管理程序”对话框提示时，键入 SharePoint 管理员帐户的帐户名和密码，然后单击“登录”。

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

现在即可使用 SharePoint Online 命令。

注意

SharePoint Online 命令行管理程序模块和 SharePoint 客户端组件 SDK 之间存在一个已知问题，即如果两者都安装在同一台计算机上，该模块将无法加载。 如果遇到此问题，请卸载 SharePoint 客户端组件 SDK。