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 命令行管理程序”。
使用用户名和密码连接
在 SharePoint Online 命令行管理程序命令提示符处运行以下命令:
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com
当出现“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) 连接
在 SharePoint Online 命令行管理程序命令提示符处运行以下命令:
Connect-SPOService -Url https://contoso-admin.sharepoint.com
当出现“Microsoft SharePoint Online 命令行管理程序”对话框提示时,键入 SharePoint 管理员帐户的帐户名和密码,然后单击“登录”。
按照“Microsoft SharePoint Online 命令行管理程序”对话框中的说明提供其他身份验证信息(如验证码),然后单击“登录”。
现在即可使用 SharePoint Online 命令。
注意
SharePoint Online 命令行管理程序模块和 SharePoint 客户端组件 SDK 之间存在一个已知问题,即如果两者都安装在同一台计算机上,该模块将无法加载。 如果遇到此问题,请卸载 SharePoint 客户端组件 SDK。