使用 PowerShell 和 PnP PowerShell 连接到 SharePoint Online

您是否希望使用 PowerShell 连接到 SharePoint Online？我将在这里详细解释如何使用 PowerShell 以及 PnP PowerShell 连接到 SharePoint Online。

您会发现本教程是最简单的教程之一，可帮助您使用 PowerShell 连接到 SharePoint Online。我会用最简单的方式解释。

如何使用 PowerShell 连接到 SharePoint Online

如果您是经验丰富的专业人士，您还可以使用 PowerShell 来管理您的 SharePoint Online。我将向您展示使用 PowerShell 连接到 SharePoint Online 网站的两种方法。

• 使用 SharePoint Online 命令行管理程序
• 使用 PnP PowerShell

1. 使用 SharePoint Online 命令行管理程序

要使用 PowerShell 使用 SharePoint Online，首先需要安装 SharePoint Online Management Shell。您可以通过两种方式安装它。

• 第一种方法是，您可以从此处下载并安装 SharePoint Online 管理 shell。

在下载页面上，您可以看到如下所示的下载选项，然后您可以按照步骤进行安装。

只需按照说明进行安装即可；我 100% 确信您在安装时不会遇到任何问题。

• 在另一种方法中，您可以运行以下 cmdlet 以从 PowerShell 库安装模块。

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

如果您没有管理员权限，则可以通过运行以下命令为当前用户安装它：

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

要检查是否安装了 SharePoint Online 管理 shell，可以使用以下 cmdlet：

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

您可以在下面的屏幕截图中看到名称和版本。我使用 VS 代码执行脚本：

如果您已经安装了它，则可以将其更新到最新版本。

要更新到最新版本的 SharePoint Online 管理 shell，请运行以下 cmdlet：

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

安装成功后，您可以使用 Connect-SPOService cmdlet 连接到 SharePoint Online。

NOTE: You need to be a SharePoint Online Administrator or Global Administrator to connect to SharePoint Online from SharePoint Online Management Shell (PowerShell).

现在，要从 PowerShell 连接到 SharePoint Online，请运行以下命令。

Connect-SPOService -Url https://<tenantname>-admin.sharepoint.com -Credential admin@<tenantname>.com

Example:

Connect-SPOService -Url https://szg52-admin.sharepoint.com -Credential [email protected]

运行上述 PowerShell cmdlet 后，它会要求您输入用户的密码，如下所示。输入密码后，您将从 PowerShell 连接到 SharePoint 网站。

您还可以使用以下 cmdlet 通过 PowerShell 连接到 SharePoint Online。

Connect-SPOService -Url https://<tenantname>-admin.sharepoint.com -Credential (Get-Credential)

在这种情况下，它会要求您输入用户名和密码。

连接成功后，您可以运行以下命令从 SharePoint Online 租户获取所有网站。

Get-SPOSite

您可以在下面的屏幕截图中看到输出：

这是使用 SharePoint Online Management Shell 从 PowerShell 连接到 SharePoint Online 的方法。

如果您想在 PowerShell 脚本本身中传递凭据，则可以像下面的 PowerShell 脚本一样编写。

$siteURL="https://szg52-admin.sharepoint.com"
$userName="[email protected]"
$password = "Mypassword@1"

$credentials = New-Object -TypeName System.Management.Automation.PSCredential -argumentlist $userName, $(convertto-securestring $password -asplaintext -force)
Connect-SPOService -Url $siteURL -Credential $credentials

阅读使用 PowerShell 或 PnP PowerShell 在 SharePoint Online 中创建列表

2. 使用 PnP PowerShell

现在，我将向您展示如何使用 PnP PowerShell 连接到 SharePoint Online。

PnP PowerShell 也称为“模式和实践 PowerShell”，是 PowerShell 的扩展，它提供了一个 PowerShell 命令 (cmdlet) 库，旨在对 SharePoint 执行复杂的配置和项目管理操作。

通过使用 PnP PowerShell，您可以使用各种 Microsoft 产品，例如 SharePoint Online、Microsoft Teams 等。

您可以按照以下三个步骤从 PnP PowerShell 连接到 SharePoint Online。

第 1 步：

首先，您需要使用以下命令安装 PnP PowerShell。

Install-Module PnP.PowerShell
Or
Install-Module PnP.PowerShell -Scope CurrentUser

注意：确保您的计算机上安装有 PowerShell 7.2 或更高版本。

您可以在下面的屏幕截图中看到输出：

第 2 步：

接下来，运行以下 cmdlet 以向您的租户进行身份验证。

Register-PnPManagementShellAccess

第 3 步：

安装成功后，您可以运行以下命令连接到 SharePoint Online 租户。

Connect-PnPOnline [tenant].sharepoint.com -Credentials (Get-Credential)
Example:
Connect-PnPOnline szg52.sharepoint.com -Credentials (Get-Credential)

要验证安装，您可以运行以下命令。

Get-Command -Module PnP.Powershell

您可以在下面的屏幕截图中看到输出：

以下是使用 PnP PowerShell 连接到 SharePoint Online 的一些其他 cmdlet。

安装 PnP PowerShell 后，您可以运行以下 cmdlet 来连接到 SharePoint Online。

Connect-PnPOnline -Url https://szg52.sharepoint.com

它会要求您输入用户名和密码。

如果您想要连接到 SharePoint Online 网站，则可以运行以下 PnP PowerShell 脚本，而不是连接到 SharePoint Online 租户：

Connect-PnPOnline -Url https://<tenantname>.sharepoint.com/sites/siteName -Credentials (Get-Credential)

Example:

Connect-PnPOnline -Url https://szg52.sharepoint.com/sites/PowerShellFAQs -Credentials (Get-Credential)

它会要求您输入用户名和密码。

您还可以使用 -UseWebLogin 参数通过 Connect-PnPOnline cmdlet 连接到 SharePoint Online。

Connect-PnPOnline -Url https://szg52.sharepoint.com -UseWebLogin

如果您想提供用户名和密码以使用 PnP PowerShell 连接到 SharePoint，您可以执行以下操作：

$siteURL="https://szg52.sharepoint.com"
$userName="[email protected]"
$password = "Mypassword@1"
 
$securePassword = ConvertTo-SecureString -String $password -AsPlainText -Force
$credentials = New-Object -TypeName System.Management.Automation.PSCredential -argumentlist $userName, $securePassword

Connect-PnPOnline -Url $siteURL -Credentials $credentials

注意：您需要将密码作为安全字符串传递。

这是使用 PnP PowerShell 连接到 SharePoint Online 的方法。

我希望您完全了解如何使用 PowerShell 连接到 SharePoint Online 和 PnP PowerShell。使用 SharePoint Online 管理 shell 或 PnP PowerShell 非常简单。您可以查看我们的 PowerShell SharePoint 教程。