如何使用 PnP PowerShell 连接到 SharePoint Online？

---

要求： 使用 PnP PowerShell 连接到 SharePoint Online。

SharePoint Online 的 SharePoint 模式和实践 (PnP) 是社区编写的一组 PowerShell cmdlet，用于高效管理 SharePoint Online。 PnP PowerShell 在内部使用客户端对象模型代码进行操作。借助 PnP PowerShell，我们可以利用其内置 cmdlet 来减少脚本中的行数并降低脚本实现的复杂性。要从 PnP PowerShell 连接到 SharePoint Online，请执行以下步骤：

更新： 步骤 1 安装旧版 PnP PowerShell 模块 SharePointPnPPowerShellOnline - 该模块已存档且不再维护！要安装最新版本的 PnP PowerShell 模块 PnP.PowerShell，请参阅：如何安装适用于 SharePoint Online 的 PnP PowerShell？
仅当您需要旧版 PnP 模块以实现向后兼容性时，才继续执行步骤 1，因为截至目前，PnP.PowerShell 模块不支持 SharePoint 本地部署（2013、2016 和 2019）。

步骤 1：安装 SharePoint Online PnP PowerShell 模块

要开始使用 PnP PowerShell，如果您运行的是 Windows 7 等操作系统，则需要从 https://www.microsoft.com/en-us/download/details.aspx?id=54616 下载并安装 Windows Management Framework 5.1 /8、Windows 2008 或 Windows 2012/R2。选择适合您的操作系统的下载并重新启动计算机以完成安装。在 Windows 10 及更高版本上，它已安装。

如何安装适用于 SharePoint Online 的 PnP PowerShell？
以管理员身份打开 SharePoint Online Management Shell 或 Windows PowerShell 并运行以下命令：

Install-Module SharePointPnPPowerShellOnline

确认提示，这将下载并安装 SharePoint Online 的 PnP 模块。此模块提供的 cmdlet 允许您轻松连接到并管理 SharePoint Online 环境。

下载 SharePoint Online PnP PowerShell：您还可以从 GitHub 下载并安装 MSI 安装程序：下载适用于 SharePoint Online (MSI) 的 PnP PowerShell，

安装 SharePoint Online PnP PowerShell 模块，如果尚未安装：

让我们检查本地计算机上是否已安装 PnP PowerShell 模块。如果没有，请安装它！

#Check if SharePoint Online PnP PowerShell module has been installed
Try {
    Write-host "Checking if SharePoint Online PnP PowerShell Module is Installed..." -f Yellow -NoNewline
    $SharePointPnPPowerShellOnline  = Get-Module -ListAvailable "SharePointPnPPowerShellOnline"

    If(!$SharePointPnPPowerShellOnline)
    {
        Write-host "No!" -f Green

        #Check if script is executed under elevated permissions - Run as Administrator
        If (-NOT ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator"))
        {   
            Write-Host "Please Run this script in elevated mode (Run as Administrator)! " -NoNewline
            Read-Host "Press any key to continue"
            Exit
        }

        Write-host "Installing SharePoint Online PnP PowerShell Module..." -f Yellow -NoNewline
        Install-Module SharePointPnPPowerShellOnline -Force -Confirm:$False
        Write-host "Done!" -f Green
    }
    Else
    {
        Write-host "Yes!" -f Green
        Write-host "Importing SharePoint Online PnP PowerShell Module..." -f Yellow  -NoNewline
        Import-Module SharePointPnPPowerShellOnline -DisableNameChecking
        Write-host "Done!" -f Green
    }
}
Catch{
    write-host "Error: $($_.Exception.Message)" -foregroundcolor red
}

更新 SharePoint Online PnP PowerShell 模块
若要更新现有 PnP PowerShell 模块，请使用以下命令：

Update-Module SharePointPnPPowerShellOnline

这解决了诸如“警告：PnP PowerShell 的较新版本可用：3.19.2003.0”之类的问题。考虑升级。”

步骤 2：使用 PnP PowerShell 连接到 SharePoint Online

安装 SharePoint Online 的 PnP PowerShell 模块后，下一步是建立与 SharePoint Online 网站的连接。 PnP PowerShell 模块连接到特定的 SharePoint Online 网站集，而不是像 SharePoint Online Management Shell 的 Connect-SPOService 那样连接到租户。以下是使用 PnP PowerShell 连接到 SharePoint Online 网站的方法：

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

系统将提示您输入连接凭据。输入用户名和密码以连接到您的 SharePoint Online 网站。您可以使用 PowerShell 控制台或 PowerShell ISE 编写 PowerShell 脚本。您还可以在脚本中对凭据进行硬编码，例如：

$SiteURL="https://Crescent.sharepoint.com"
$UserName="[email protected]"
$Password = "password"

$SecurePassword = ConvertTo-SecureString -String $Password -AsPlainText -Force
$Cred = New-Object -TypeName System.Management.Automation.PSCredential -argumentlist $UserName, $SecurePassword

#connect to sharepoint online site using powershell
Connect-PnPOnline -Url $SiteURL -Credentials $Cred

您还可以使用客户端 ID 和客户端密钥方法从 PnP PowerShell 连接到 SharePoint Online：如何使用 ClientID ClientSecret 连接到 SharePoint Online？

从 PnP PowerShell 连接到 SharePoint Online 所需的权限：从 PnP PowerShell 连接到 SharePoint Online 需要哪些权限？全局管理员？那么，这取决于您正在运行的 cmdlet。例如，如果您需要从列表中获取项目，则读取权限就足够了，而您需要租户管理员权限才能创建新的网站集！

使用 PnP PowerShell MFA 连接到 SharePoint Online

您还可以使用 -Interactive 开关从当前登录用户的会话进行连接。如果没有找到现有会话，您将看到一个用于登录的浏览器窗口，这是 MFA 感知的！

Connect-PnPOnline -Url $SiteURL -UseWebLogin

在新的 PnP.PowerShell 中，我们有一个改进的开关“-Interactive”，可以与启用多重身份验证的帐户一起使用。如果您收到“Connect-PnPOnline：找不到与参数名称‘Interactive’匹配的参数。”，这意味着您没有运行最新的 PnP PowerShell 模块。因此，您的选择是升级 PnP PowerShell 模块或将“Interactive”开关替换为“UseWebLogin”。建立连接后，您可以开始使用 PnP PowerShell cmdlet。以下是在 SharePoint Online 中使用 PnP PowerShell cmdlet 的一些示例：

创建列表或文档库：

要使用 PnP PowerShell 在 SharePoint Online 中创建文档库，请使用：

New-PnPList -Title "Team Documents" -Template DocumentLibrary

如何在 PnP PowerShell 中创建列表？这是一个例子：

New-PnPList -Title "ProjectsV3" -Template GenericList

参考：https://pnp.github.io/powershell/cmdlets/new-pnplist.html

创建子网站：

New-PnPWeb -Title "emea" -Url "emea" -Template "STS#0"

SharePoint Online PnP PowerShell 创建网站集
下面是使用 PnP PowerShell 创建网站集的另一个示例。

#Define Variables
$AdminCenterURL = "https://Crescent-admin.sharepoint.com"
$SiteURL = "https://Crescent.sharepoint.com/sites/procurement"
$SiteTitle = "Crescent Procurement Portal"
$SiteOwner = "[email protected]"
$Template = "STS#0"
$Timezone = 4
$StorageQuota = 1000 

#Get Credentials to connect
$Cred = Get-Credential

#Connect to Tenant Admin
Connect-PnPOnline -URL $AdminCenterURL -Credential $Cred

#Create site collection based on given parameters
New-PnPTenantSite -Url $SiteURL -Owner $SiteOwner -Title $SiteTitle -Template $Template -TimeZone $TimeZone -StorageQuota $StorageQuota

使用 Windows 凭据存储中的凭据连接到 PnP 在线：
为了避免凭据弹出窗口，您可以将凭据存储在 Windows 凭据存储中并连接到 PnP 在线，而无需用户名密码提示！具体方法如下：

1. 打开控制面板 >> Windows 凭据管理器
2. 选择 Windows 凭据 >> 单击“添加新的通用凭据”

3. 输入您的 SharePoint 站点 URL、用户名和密码，然后单击“保存”。

   

从现在开始，您可以使用指定的 URL 连接到 PnP Online，无需 Credentials 参数。它也适用于给定 URL 下的任何网站！
例如。

Connect-PnPOnline -Url "https://Crescent.sharepoint.com" 

SharePoint Online：获取 PnP PowerShell 命令

要获取 PnP PowerShell 的所有可用 cmdlet，请使用：

Get-Command -Module SharePointPnPPowerShellOnline

目前，SharePoint Online 的 PnP PowerShell 模块中有 370 个 cmdlet 可用。

Add-PnPApp

将可用应用程序添加/上传到应用程序目录。 * SharePoint Online 支持。

Add-PnPPage

添加客户端页面。 * SharePoint Online 支持。

Add-PnPPageSection

向客户端页面添加新部分。 * 在 SharePoint Online 中受支持。

Add-PnPPageTextPart

将文本元素添加到客户端页面。 * SharePoint Online 支持。

Add-PnPPageWebPart

将客户端 Web 部件添加到客户端页面。 * 在 SharePoint Online 中受支持。

Add-PnPContentType

添加新的内容类型

Add-PnPContentTypeToDocumentSet

将内容类型添加到文档集

Add-PnPContentTypeToList

将新的内容类型添加到列表中

Add-PnPCustomAction

添加自定义操作

Add-PnPDataRowsToSiteTemplate

将数据行添加到 PnP 配置模板内的列表

Add-PnPDocumentSet

在库中创建新文档集。

Add-PnPEventReceiver

添加新的远程事件接收器

Add-PnPField

添加字段

Add-PnPFieldFromXml

根据 CAML/XML 字段定义将字段添加到列表或作为网站栏

Add-PnPFieldToContentType

将现有网站栏添加到内容类型

Add-PnPFile

将文件上传到 Web

Add-PnPFileToSiteTemplate

将文件添加到 PnP 配置模板

Add-PnPFolder

在父文件夹中创建文件夹

Add-PnPHtmlPublishingPageLayout

添加基于 HTML 的发布页面布局

Add-PnPHubSiteAssociation

将站点连接到 hubsite。 * SharePoint Online 支持。

Add-PnPIndexedProperty

标记指定要通过搜索索引的属性包键的值。

Add-PnPJavaScriptBlock

将 JavaScript 代码段/块的链接添加到网络或网站集

Add-PnPJavaScriptLink

将 JavaScript 文件的链接添加到 Web 或网站集

Add-PnPListFoldersToSiteTemplate

将文件夹添加到 PnP 配置模板的列表中

Add-PnPListItem

将项目添加到列表中

Add-PnPMasterPage

添加母版页

Add-PnPNavigationNode

将项目添加到导航元素

Add-PnPMicrosoft365GroupToSite

通过为其创建 Office 365 组并将该网站与新创建的组连接来对经典团队网站进行分组。 * 在 SharePoint Online 中受支持。

Add-PnPSiteTemplate

将 PnP 配置模板对象添加到租户模板。 * 在 SharePoint Online 中受支持。

Add-PnPPublishingImageRendition

如果图像呈现的名称尚不存在，则添加图像呈现。这可以防止创建两个共享相同名称的图像再现。

Add-PnPPublishingPage

添加发布页面

Add-PnPPublishingPageLayout

添加发布页面布局

Add-PnPRoleDefinition

将角色定义（权限级别）添加到当前上下文中的网站集

Add-PnPSiteClassification

将一个或多个站点分类值添加到可能值列表中。需要连接到 Microsoft Graph。 * SharePoint Online 支持。

Add-PnPSiteCollectionAdmin

将一名或多名用户作为网站集管理员添加到当前上下文中的网站集

Add-PnPSiteCollectionAppCatalog

将网站集范围内的应用程序目录添加到网站。 * SharePoint Online 支持。

Add-PnPSiteDesign

在当前租户上创建新的站点设计。 * 在 SharePoint Online 中受支持。

Add-PnPSiteDesignTask

此命令用于将已发布的网站设计应用到指定的网站集目标。它安排允许应用较大站点脚本的操作（Invoke-PnPSiteDesign 仅限于 30 个操作和子操作）。此命令旨在替换 Invoke-PnPSiteDesign，并且在您需要应用大量操作或多个站点脚本时非常有用。 * SharePoint Online 支持。

Add-PnPSiteScript

在当前租户上创建新的站点脚本。 * SharePoint Online 支持。

Add-PnPStoredCredential

将凭据添加到 Windows 凭据管理器

Add-PnPTaxonomyField

添加分类字段

Add-PnPTenantCdnOrigin

向公共或私有内容分发网络 (CDN) 添加新源。 * 在 SharePoint Online 中受支持。

Add-PnPTenantSequence

将租户序列对象添加到租户模板。 * SharePoint Online 支持。

Add-PnPTenantSequenceSite

将现有租户序列站点对象添加到租户模板。 * 在 SharePoint Online 中受支持。

Add-PnPTenantSequenceSubSite

将租户序列子站点对象添加到租户序列站点对象。 * 在 SharePoint Online 中受支持。

Add-PnPTenantTheme

向租户添加或更新主题。 * 在 SharePoint Online 中受支持。

Add-PnPGroupMember

将用户添加到组中

Add-PnPView

将视图添加到列表

Add-PnPWebhookSubscription

添加新的 Webhook 订阅。 * SharePoint Online 支持。

Add-PnPWebPartToWebPartPage

将 Web 部件添加到指定区域中的 Web 部件页面

Add-PnPWebPartToWikiPage

将 Web 部件添加到指定表行和列中的 wiki 页面

Add-PnPWikiPage

添加 wiki 页面

Add-PnPWorkflowDefinition

添加工作流程定义

Add-PnPWorkflowSubscription

将工作流订阅添加到列表中

Invoke-PnPSiteTemplate

将网站模板应用到网站

Apply-PnPTenantTemplate

将租户模板应用于当前租户。 * SharePoint Online 支持。

Approve-PnPTenantServicePrincipalPermissionRequest

批准当前租户的“SharePoint Online 客户端”服务主体的权限请求。 * 在 SharePoint Online 中受支持。

Clear-PnPDefaultColumnValues

清除文档库的默认列值

Clear-PnPListItemAsRecord

取消将列表项声明为记录。 * 在 SharePoint Online 中受支持。

Clear-PnPRecycleBinItem

永久删除所有或特定回收站项目

Clear-PnPTenantRecycleBinItem

从租户范围的回收站中永久删除网站集

Connect-PnPMicrosoftGraph

连接到 Microsoft Graph

Connect-PnPOnline

连接到 SharePoint 网站

Convert-PnPFolderToSiteTemplate

创建现有模板 xml 的 pnp 包文件，并包含当前文件夹中的所有文件

Convert-PnPSiteTemplate

将配置模板转换为另一个架构版本

ConvertTo-PnPPage

将经典页面（wiki 或 Web 部件页面）转换为客户端页面。 * 在 SharePoint Online 中受支持。

Copy-PnPFile

将文件或文件夹复制到其他位置

Copy-PnPItemProxy

用于在 SharePoint 提供程序和文件系统提供程序之间使用 Copy-Item 的代理 cmdlet

Deny-PnPTenantServicePrincipalPermissionRequest

拒绝当前租户的“SharePoint Online 客户端”服务主体的权限请求。 * SharePoint Online 支持。

Disable-PnPFeature

禁用某项功能

Disable-PnPInPlaceRecordsManagementForSite

禁用站点的就地记录管理。

Disable-PnPPowerShellTelemetry

禁用 PnP PowerShell 遥测跟踪

Disable-PnPResponsiveUI

停用 PnP 响应 UI 插件

Disable-PnPSiteClassification

禁用租户的站点分类。需要连接到 Microsoft Graph。 * SharePoint Online 支持。

Disable-PnPTenantServicePrincipal

启用当前租户的“SharePoint Online Client”服务主体。 * SharePoint Online 支持。

Disconnect-PnPOnline

断开上下文连接

Enable-PnPFeature

启用一项功能

Enable-PnPInPlaceRecordsManagementForSite

为站点启用就地记录管理。

Enable-PnPPowerShellTelemetry

启用 PnP PowerShell 遥测跟踪。

Enable-PnPResponsiveUI

激活 PnP 响应 UI 插件

Enable-PnPSiteClassification

为租户启用站点分类。需要连接到 Microsoft Graph。 * 在 SharePoint Online 中受支持。

Enable-PnPTenantServicePrincipal

启用当前租户的“SharePoint Online 客户端”服务主体。 * 在 SharePoint Online 中受支持。

Export-PnPPage

将客户端页面导出到 PnP 配置模板。 * SharePoint Online 支持。

Export-PnPTaxonomy

将分类导出到输出或文件。

Export-PnPTermGroupToXml

将分类术语组导出到输出或 XML 文件。

Find-PnPFile

在网络虚拟文件系统中查找文件。

Get-PnPAccessToken

返回当前 OAuth 访问令牌

Get-PnPApp

返回应用程序目录中的可用应用程序。 * SharePoint Online 支持。

Get-PnPAppAuthAccessToken

返回访问令牌

Get-PnPApp

返回 SharePoint 外接程序实例

Get-PnPAuditing

获取站点的审核设置

Get-PnPAuthenticationRealm

返回认证领域

Get-PnPAvailableClientSideComponents

获取特定页面上可用的客户端组件。 * 在 SharePoint Online 中受支持。

Get-PnPAzureADManifestKeyCredentials

返回 Azure 应用程序的 JSON 清单片段

Get-PnPAzureCertificate

获取现有证书 (.pfx) 的 PEM 值和清单设置，以便在通过仅限应用程序的 ADAL 应用程序使用 CSOM 时使用。

Get-PnPClientSideComponent

从页面中检索一个或多个客户端组件。 * SharePoint Online 支持。

Get-PnPClientSidePage

获取客户端页面。 * 在 SharePoint Online 中受支持。

Get-PnPConnection

返回当前上下文

Get-PnPContentType

检索内容类型

Get-PnPContentTypePublishingHubUrl

返回内容类型发布中心的 URL

Get-PnPContext

返回当前上下文

Get-PnPCustomAction

返回用户自定义操作

Get-PnPDefaultColumnValues

获取文档库中所有文件夹的默认列值

Get-PnPDocumentSetTemplate

检索文档集模板

Get-PnPEventReceiver

返回注册的事件接收者

Get-PnPException

返回最后发生的异常

Get-PnPFeature

返回所有激活的或特定激活的功能

Get-PnPField

从列表或站点返回字段

Get-PnPFile

下载文件。

Get-PnPFolder

返回一个文件夹对象

Get-PnPFolderItem

列出文件夹中的内容

Get-PnPGroup

返回网站中的特定 SharePoint 组或所有 SharePoint 组。

Get-PnPGroupMember

检索组的所有成员

Get-PnPGroupPermissions

返回特定 SharePoint 组的权限

Get-PnPHealthScore

检索健康分数

Get-PnPHideDefaultThemes

返回默认/OOTB 主题是否对用户可见。 * SharePoint Online 支持。

Get-PnPHomePage

返回首页

Get-PnPHubSite

检索所有或特定的 hubsite。 * SharePoint Online 支持。

Get-PnPIndexedPropertyKeys

返回已标记为通过搜索建立索引的属性包值的键

Get-PnPInPlaceRecordsManagement

返回是否启用地点记录管理功能。

Get-PnPJavaScriptLink

返回位置类型 ScriptLink 的所有或特定自定义操作

Get-PnPLabel

获取指定列表或库的标签/标签（如果适用）。 * SharePoint Online 支持。

Get-PnPList

返回一个列表对象

Get-PnPListInformationRightsManagement

获取应用了网站策略的网站的网站关闭状态

Get-PnPListItem

检索列表项

Get-PnPListRecordDeclaration

返回列表的手动记录声明设置。 * 在 SharePoint Online 中受支持。

Get-PnPMasterPage

返回默认母版页和自定义母版页的 URL。

Get-PnPNavigationNode

返回所有或特定导航节点

Get-PnPPowerShellTelemetryEnabled

如果已启用 PnP PowerShell 遥测，则返回 true。

Get-PnPProperty

返回 ClientObject 之前未加载的属性

Get-PnPPropertyBag

返回属性包值。

Get-PnPSiteTemplate

从 Web 生成配置站点模板

Get-PnPProvisioningTemplateFromGallery

从 PnP 模板库检索或搜索配置模板

Get-PnPPublishingImageRendition

返回所有图像再现，或者如果指定了 Identity，则返回特定图像再现

Get-PnPRecycleBinItem

从上下文中返回回收站中的项目

Get-PnPRequestAccessEmails

返回请求访问的电子邮件地址。 * 在 SharePoint Online 中受支持。

Get-PnPRoleDefinition

检索站点的角色定义

Get-PnPSearchConfiguration

返回搜索配置

Get-PnPSearchCrawlLog

返回 SharePoint 搜索爬网日志中的条目。 * SharePoint Online 支持。

Get-PnPSite

从上下文返回当前网站集。

Get-PnPSiteClassification

返回为租户定义的站点分类。需要连接到 Microsoft Graph。 * SharePoint Online 支持。

Get-PnPSiteClosure

获取应用了网站策略的网站的网站关闭状态

Get-PnPSiteCollectionAdmin

返回当前上下文中网站集的当前网站集管理员

Get-PnPSiteCollectionTermStore

返回网站集术语库

Get-PnPSiteDesign

检索已在当前租户上注册的站点设计。 * SharePoint Online 支持。

Get-PnPSiteDesignRights

返回对特定站点设计拥有设计权的委托人。 * 在 SharePoint Online 中受支持。

Get-PnPSiteDesignRun

检索应用于指定网站集的网站设计列表。如果未指定 WebUrl 参数，我们将显示应用于当前站点的设计列表。返回的输出包括计划作业的 ID、网站和站点 ID 以及站点设计 ID、版本和标题。 * SharePoint Online 支持。

Get-PnPSiteDesignRunStatus

检索并显示为应用于站点的指定站点设计执行的所有站点脚本操作的列表。 * SharePoint Online 支持。

Get-PnPSiteDesignTask

用于检索预定的站点设计脚本。它采用计划的网站设计的 ID 和计划应用该网站设计的网站的 URL。 * SharePoint Online 支持。

Get-PnPSitePolicy

检索所有或特定站点策略

Get-PnPSiteScript

检索已在当前租户上注册的站点脚本。 * SharePoint Online 支持。

Get-PnPSiteSearchQueryResults

执行搜索查询以检索索引的网站集

Get-PnPStorageEntity

从租户应用程序目录或当前站点（如果具有站点范围应用程序目录）检索存储实体/场属性。 * 在 SharePoint Online 中受支持。

Get-PnPStoredCredential

获取凭证

Get-PnPSubWeb

返回当前网站的子网站

Get-PnPTaxonomyItem

返回分类项目

Get-PnPTaxonomySession

返回分类会话

Get-PnPTenant

返回组织级别网站集属性。 * SharePoint Online 支持。

Get-PnPTenantAppCatalogUrl

检索租户范围内的应用程序目录的 url。 * 在 SharePoint Online 中受支持。

Get-PnPTenantCdnEnabled

检索 Office 365 内容交付网络是否已启用。 * SharePoint Online 支持。

Get-PnPTenantCdnOrigin

返回来自公共或私有内容分发网络 (CDN) 的当前注册源。 * 在 SharePoint Online 中受支持。

Get-PnPTenantCdnPolicies

返回指定 CDN（公共 | 私有）的 CDN 策略。 * 在 SharePoint Online 中受支持。

Get-PnPTenantRecycleBinItem

返回租户范围回收站中的所有现代和经典网站集。 * 在 SharePoint Online 中受支持。

Get-PnPTenantSequence

从租户模板返回一个或多个配置序列对象

Get-PnPTenantSequenceSite

从租户模板返回一个或多个站点

Get-PnPTenantServicePrincipal

返回当前租户的“SharePoint Online Client”服务主体。 * 在 SharePoint Online 中受支持。

Get-PnPTenantServicePrincipalPermissionGrants

获取“SharePoint Online 客户端”服务主体的权限授予集合。 * SharePoint Online 支持。

Get-PnPTenantServicePrincipalPermissionRequests

获取“SharePoint Online 客户端”服务主体的权限请求的集合。 * 在 SharePoint Online 中受支持。

Get-PnPTenantSite

检索站点信息。 * 在 SharePoint Online 中受支持。

Get-PnPTenantTheme

返回全部或特定主题。 * SharePoint Online 支持。

Get-PnPTerm

返回分类术语

Get-PnPTermGroup

返回分类术语组

Get-PnPTermSet

返回分类术语集

Get-PnPTheme

返回当前网页的当前主题/组合外观。

Get-PnPTimeZoneId

返回时区 ID

Get-PnPUnifiedGroup

获取一个 Office 365 组（也称为统一组）或 Office 365 组列表。 * SharePoint Online 支持。

Get-PnPUnifiedGroupMembers

获取特定 Office 365 组（也称为统一组）的成员。 * SharePoint Online 支持。

Get-PnPUnifiedGroupOwners

获取特定 Office 365 组（也称为统一组）的所有者。 * 在 SharePoint Online 中受支持。

Get-PnPUPABulkImportStatus

获取用户配置文件批量导入状态。 * SharePoint Online 支持。

Get-PnPUser

返回当前网站的网站用户

Get-PnPUserProfileProperty

您必须使用 Connect-PnPOnline 连接到租户管理网站 (https://:-admin.sharepoint.com) 才能使用此 cmdlet。

Get-PnPView

返回列表中的一个或所有视图

Get-PnPWeb

返回当前的网络对象

Get-PnPWebhookSubscriptions

获取资源的所有 Webhook 订阅。 * 在 SharePoint Online 中受支持。

Get-PnPWebPart

返回 Web 部件定义对象

Get-PnPWebPartProperty

返回 Web 部件属性

Get-PnPWebPartXml

返回在网站上注册的 Web 部件的 Web 部件 XML

Get-PnPWebTemplates

返回可用的 Web 模板。 * 在 SharePoint Online 中受支持。

Get-PnPWikiPageContent

获取 wiki 页面的内容/来源

Get-PnPWorkflowDefinition

返回工作流定义

Get-PnPWorkflowInstance

获取工作流实例

Get-PnPWorkflowSubscription

返回工作流订阅

Grant-PnPHubSiteRights

向已存在的权限授予附加权限，以便将一个或多个特定用户的网站关联到中心网站。 * 在 SharePoint Online 中受支持。

Grant-PnPSiteDesignRights

授予指定主体使用站点设计的权利。 * SharePoint Online 支持。

Grant-PnPTenantServicePrincipalPermission

向“SharePoint Online 客户端”服务主体显式授予指定权限。 * 在 SharePoint Online 中受支持。

Import-PnPAppPackage

将 SharePoint 外接程序添加到网站

Import-PnPTaxonomy

从字符串数组或文件导入分类法

Import-PnPTermGroupFromXml

从输入或 XML 文件导入分类术语组。

Import-PnPTermSet

从标准格式的文件导入分类术语集。

Install-PnPApp

从应用程序目录安装可用的应用程序。 * 在 SharePoint Online 中受支持。

Install-PnPSolution

将沙盒解决方案安装到网站集。警告！由于激活解决方案所用的方法，此方法可能会删除您的组合外观库。我们建议您仅在您同意的情况下才使用此 cmdlet。

Invoke-PnPQuery

执行当前排队的操作

Invoke-PnPSiteDesign

将站点设计应用到现有站点。 * 需要租户管理权 *。 * 在 SharePoint Online 中受支持。

Invoke-PnPWebAction

在网络、列表和列表项上执行操作。

Measure-PnPList

返回列表对象的统计信息 - * 支持：SharePoint Online、SharePoint 2016、SharePoint 2019。

Measure-PnPResponseTime

通过发送探测请求获取指定端点的响应时间统计信息

Measure-PnPWeb

返回 Web 对象的统计信息 - * 支持：SharePoint Online、SharePoint 2016、SharePoint 2019。

Move-PnPClientSideComponent

将客户端组件移动到不同的部分/列。 * SharePoint Online 支持。

Move-PnPFile

将文件移动到不同位置

Move-PnPFolder

将文件夹移动到当前 Web 中的另一个位置

Move-PnPItemProxy

用于在 SharePoint 提供程序和文件系统提供程序之间使用 Move-Item 的代理 cmdlet

Move-PnPListItemToRecycleBin

将列表中的项目移动到回收站

Move-PnPRecycleBinItem

将当前网站集第一阶段回收站中的所有项目或特定项目移动到第二阶段回收站。 * 在 SharePoint Online 中受支持。

New-PnPAzureCertificate

生成新的 2048 位自签名证书和清单设置，以便在通过仅限应用程序的 ADAL 应用程序使用 CSOM 时使用。

New-PnPExtensibilityHandlerObject

创建 ExtensibilityHandler 对象，供 Get-SPOProvisioningTemplate cmdlet 使用

New-PnPGroup

将组添加到站点组列表并返回组对象

New-PnPList

创建一个新列表

New-PnPPersonalSite

仅限 Office365：创建个人/OneDrive For Business 网站。 * SharePoint Online 支持。

New-PnPSiteTemplate

创建新的配置模板对象

New-PnPSiteTemplateFromFolder

从给定文件夹生成配置模板，仅包括该文件夹中存在的文件

New-PnPSite

创建新的网站集。 * SharePoint Online 支持。

New-PnPTenantSequence

创建一个新的租户序列对象。 * 在 SharePoint Online 中受支持。

New-PnPTenantSequenceCommunicationSite

创建通信站点对象。 * 在 SharePoint Online 中受支持。

New-PnPTenantSequenceTeamNoGroupSite

创建没有 Office 365 组内存对象的新团队网站。 * 在 SharePoint Online 中受支持。

New-PnPTenantSequenceTeamNoGroupSubSite

创建不带 Office 365 组对象的团队网站子网站。 * 在 SharePoint Online 中受支持。

New-PnPTenantSequenceTeamSite

创建团队网站对象。 * SharePoint Online 支持。

New-PnPTenantSite

为当前租户创建新网站集

New-PnPTenantTemplate

创建新的租户模板对象。 * SharePoint Online 支持。

New-PnPTerm

创建分类术语

New-PnPTermGroup

创建分类术语组

New-PnPTermSet

创建分类术语集

New-PnPUnifiedGroup

创建新的 Office 365 组（又名统一组）。 * 在 SharePoint Online 中受支持。

New-PnPUPABulkImportJob

提交新的用户配置文件批量导入作业。 * SharePoint Online 支持。

New-PnPUser

将用户添加到内置站点用户信息列表并返回用户对象

New-PnPWeb

在当前站点下创建一个新的子站点

Publish-PnPApp

发布/部署/信任应用程序目录中的可用应用程序。 * 在 SharePoint Online 中受支持。

Read-PnPSiteTemplate

从文件系统加载/读取 PnP 文件

Read-PnPTenantTemplate

从文件系统加载/读取 PnP 租户模板并返回该模板的内存实例。 * SharePoint Online 支持。

Register-PnPHubSite

将站点注册为中心站点。 * SharePoint Online 支持。

Remove-PnPApp

从应用程序目录中删除应用程序。 * 在 SharePoint Online 中受支持。

Remove-PnPClientSideComponent

从页面中删除客户端组件。 * 在 SharePoint Online 中受支持。

Remove-PnPClientSidePage

删除客户端页面。 * SharePoint Online 支持。

Remove-PnPContentType

从网络中删除内容类型

Remove-PnPContentTypeFromDocumentSet

从文档集中删除内容类型

Remove-PnPContentTypeFromList

从列表中删除内容类型

Remove-PnPCustomAction

删除自定义操作

Remove-PnPEventReceiver

删除事件接收器

Remove-PnPField

从列表或站点中删除字段

Remove-PnPFieldFromContentType

从内容类型中删除网站栏

Remove-PnPFile

删除一个文件。

Remove-PnPFileFromSiteTemplate

从 PnP 配置模板中删除文件

Remove-PnPFolder

删除父文件夹中的文件夹

Remove-PnPGroup

从网络中删除组。

Remove-PnPHubSiteAssociation

断开站点与 hubsite 的连接。 * 在 SharePoint Online 中受支持。

Remove-PnPIndexedProperty

从属性包中删除要通过搜索建立索引的键。键及其值保留在属性包中，但不会再被索引。

Remove-PnPJavaScriptLink

从网站或网站集中删除 JavaScript 链接或块

Remove-PnPList

删除列表

Remove-PnPListItem

从列表中删除项目

Remove-PnPNavigationNode

从快速启动或顶部导航中删除菜单项

Remove-PnPPropertyBagValue

从属性包中删除一个值

Remove-PnPPublishingImageRendition

删除现有的图像再现

Remove-PnPRoleDefinition

从站点中删除角色定义

Remove-PnPSearchConfiguration

删除搜索配置

Remove-PnPSiteClassification

从可用值列表中删除一个或多个现有站点分类值。需要连接到 Microsoft Graph。 * 在 SharePoint Online 中受支持。

Remove-PnPSiteCollectionAdmin

从当前上下文中的网站集删除作为网站集管理员的一名或多名用户

Remove-PnPSiteCollectionAppCatalog

从网站中删除网站集范围内的应用程序目录。 * 在 SharePoint Online 中受支持。

Remove-PnPSiteDesign

删除站点设计。 * SharePoint Online 支持。

Remove-PnPSiteDesignTask

删除站点设计任务。如果关联站点脚本的执行已经开始，则不会终止执行。 * 在 SharePoint Online 中受支持。

Remove-PnPSiteScript

删除站点脚本。 * SharePoint Online 支持。

Remove-PnPStorageEntity

如果网站具有网站集范围的应用程序目录，则从租户范围的应用程序目录或当前网站集中删除存储实体/场属性。 * SharePoint Online 支持。

Remove-PnPStoredCredential

删除凭证

Remove-PnPTaxonomyItem

删除分类项目

Remove-PnPTenantCdnOrigin

从公共或私有内容分发网络 (CDN) 中删除源。 * 在 SharePoint Online 中受支持。

Remove-PnPTenantSite

删除网站集。 * 在 SharePoint Online 中受支持。

Remove-PnPTenantTheme

删除主题。 * 在 SharePoint Online 中受支持。

Remove-PnPTermGroup

删除分类术语组及其所有包含的术语集

Remove-PnPUnifiedGroup

删除一个 Office 365 组（也称为统一组）或一组 Office 365 组。 * 在 SharePoint Online 中受支持。

Remove-PnPUser

从网站集用户信息列表中删除特定用户

Remove-PnPGroupMember

从组中删除用户

Remove-PnPView

从列表中删除视图

Remove-PnPWeb

删除当前网站中的子网站

Remove-PnPWebhookSubscription

从资源中删除 Webhook 订阅。 * 在 SharePoint Online 中受支持。

Remove-PnPWebPart

从页面中删除 Web 部件

Remove-PnPWikiPage

删除 wiki 页面

Remove-PnPWorkflowDefinition

删除工作流程定义

Remove-PnPWorkflowSubscription

删除工作流订阅

Rename-PnPFile

在当前位置重命名文件

Rename-PnPFolder

重命名文件夹

Request-PnPReIndexList

在下一次增量爬网期间将列表标记为完整索引

Request-PnPReIndexWeb

在下一次增量爬网期间将网络标记为完整索引

Reset-PnPFileVersion

将文件重置为其之前的版本

Resolve-PnPFolder

从给定站点相对路径返回一个文件夹，如果不存在则创建它。

Restore-PnPRecycleBinItem

将提供的回收站项目恢复到其原始位置

Restore-PnPTenantRecycleBinItem

从租户范围的回收站恢复网站集。 * 在 SharePoint Online 中受支持。

Resume-PnPWorkflowInstance

恢复工作流程

Revoke-PnPSiteDesignRights

撤销指定主体使用站点设计的权利。 * 在 SharePoint Online 中受支持。

Revoke-PnPTenantServicePrincipalPermission

撤销之前授予“SharePoint Online 客户端”服务主体的权限。 * SharePoint Online 支持。

Save-PnPSiteTemplate

将 PnP 站点模板保存到文件系统

Save-PnPTenantTemplate

将 PnP 配置层次结构保存到文件系统。 * SharePoint Online 支持。

Send-PnPMail

根据指定的参数，使用 Office 365 SMTP 服务或 SharePoint 发送电子邮件。请参阅详细帮助以获取更多信息。

Set-PnPAppSideLoading

在站点上启用应用程序侧加载功能

Set-PnPAuditing

设置站点的审核设置

Set-PnPAvailablePageLayouts

设置当前站点的可用页面布局

Set-PnPPage

设置客户端页面的参数。 * 在 SharePoint Online 中受支持。

Set-PnPClientSideText

设置客户端文本组件属性。 * 在 SharePoint Online 中受支持。

Set-PnPClientSideWebPart

设置客户端 Web 部件属性。 * 在 SharePoint Online 中受支持。

Set-PnPContext

设置客户端上下文

Set-PnPDefaultColumnValues

设置文档库的默认列值

Set-PnPDefaultContentTypeToList

设置列表的默认内容类型

Set-PnPDefaultPageLayout

将特定页面布局设置为发布网站的默认页面布局

Set-PnPDocumentSetField

将网站栏从可用内容类型设置为文档集

Set-PnPField

更改特定列表或整个网络中字段的一个或多个属性

Set-PnPFileCheckedIn

签入文件

Set-PnPFileCheckedOut

签出一个文件

Set-PnPGroup

更新一个群组

Set-PnPGroupPermissions

添加和/或删除特定 SharePoint 组的权限

Set-PnPHideDefaultThemes

定义默认/OOTB 主题是否对用户可见。 * SharePoint Online 支持。

Set-PnPHomePage

设置当前网页的主页。

Set-PnPHubSite

设置 hubsite 属性。 * 在 SharePoint Online 中受支持。

Set-PnPIndexedProperties

标记要通过搜索索引的属性包的值。请注意，这将覆盖现有标志，即只有您使用 cmdlet 定义的属性才会被索引。

Set-PnPInPlaceRecordsManagement

激活或停用场所记录管理功能。

Set-PnPLabel

在指定列表或库上设置标签/标记。 * SharePoint Online 支持。

Set-PnPList

更新列表设置

Set-PnPListInformationRightsManagement

获取应用了网站策略的网站的网站关闭状态

Set-PnPListItem

更新列表项

Set-PnPListItemAsRecord

将列表项声明为记录。 * SharePoint Online 支持。

Set-PnPListItemPermission

设置列表项权限

Set-PnPListPermission

设置列表权限

Set-PnPListRecordDeclaration

RecordDeclaration 参数支持 4 个值：AlwaysAllowManualDeclaration、NeverAllowManualDeclaration、UseSiteCollectionDefaults。 * 在 SharePoint Online 中受支持。

Set-PnPMasterPage

设置母版页

Set-PnPMinimalDownloadStrategy

激活或停用最小下载策略。

Set-PnPPropertyBagValue

设置属性包值

Set-PnPSiteTemplateMetadata

设置配置模板的元数据

Set-PnPRequestAccessEmails

在网络上设置请求访问电子邮件。 * SharePoint Online 支持。

Set-PnPSearchConfiguration

设置搜索配置

Set-PnPSite

设置网站集属性。 * SharePoint Online 支持。

Set-PnPSiteClosure

打开或关闭应用了站点策略的站点

Set-PnPSiteDesign

更新当前租户的站点设计。 * 在 SharePoint Online 中受支持。

Set-PnPSitePolicy

设置站点策略

Set-PnPSiteScript

更新当前租户上的现有站点脚本。 * 在 SharePoint Online 中受支持。

Set-PnPStorageEntity

在租户范围的应用程序目录或网站集应用程序目录中设置存储实体/场属性。 * 在 SharePoint Online 中受支持。

Set-PnPTaxonomyFieldValue

在列表项字段中设置分类术语值

Set-PnPTenant

设置组织级别网站集属性。 * SharePoint Online 支持。

Set-PnPTenantCdnEnabled

启用或禁用公共或专用 Office 365 内容分发网络 (CDN)。 * 在 SharePoint Online 中受支持。

Set-PnPTenantCdnPolicy

设置指定 CDN 的 CDN 策略（公共 | 私有）。 * SharePoint Online 支持。

Set-PnPTenantSite

设置站点信息。 * 在 SharePoint Online 中受支持。

Set-PnPTheme

设置当前网页的主题。

Set-PnPTraceLog

打开或关闭日志跟踪

Set-PnPUnifiedGroup

设置 Office 365 组（又名统一组）属性。 * SharePoint Online 支持。

Set-PnPUserProfileProperty

仅限 Office365：使用租户 API 检索站点信息。

Set-PnPView

更改视图属性

Set-PnPWeb

在 Web 上设置属性

Set-PnPWebhookSubscription

更新 Webhook 订阅。 * SharePoint Online 支持。

Set-PnPWebPartProperty

设置 Web 部件属性

Set-PnPWebPermission

设置权限

Set-PnPWebTheme

设置当前网页的主题。 * SharePoint Online 支持。

Set-PnPWikiPageContent

设置维基页面的内容

Start-PnPWorkflowInstance

在列表项上启动工作流实例

Stop-PnPWorkflowInstance

停止工作流实例

Submit-PnPSearchQuery

针对 SharePoint 搜索索引执行任意搜索查询

Test-PnPListItemIsRecord

检查列表项是否是记录。 * SharePoint Online 支持。

Test-PnPOffice365GroupAliasIsUsed

测试给定的别名是否已被使用。 * 在 SharePoint Online 中受支持。

Test-PnPTenantTemplate

测试租户模板是否存在无效引用

Uninstall-PnPApp

从站点卸载可用的加载项

Uninstall-PnPApp

从网站中删除应用程序

Uninstall-PnPSolution

从网站集中卸载沙盒解决方案

Unpublish-PnPApp

从应用程序目录中取消发布/收回可用的加载项。 * SharePoint Online 支持。

Unregister-PnPHubSite

取消将站点注册为中心站点。 * SharePoint Online 支持。

Update-PnPApp

更新应用程序目录中的可用应用程序。 * SharePoint Online 支持。

Update-PnPSiteClassification

更新租户的站点分类。需要连接到 Microsoft Graph。 * 在 SharePoint Online 中受支持。

经常问的问题：

如何从 PowerShell 连接到 Azure Active Directory？

要使用 PowerShell 连接到 Azure AD，请安装 Azure Active Directory 的 PowerShell 模块“Install-Module AzureAD”。安装后，您可以使用“Connect-AzureAD”连接到 Azure AD。
更多信息：在 PowerShell 中连接到 Azure AD

如何使用 PowerShell 连接到 Microsoft 团队？

使用“Install-Module -Name MicrosoftTeams”安装适用于 Microsoft Teams 的 PowerShell 模块。安装后，您可以使用“Connect-MicrosoftTeams”连接到 Teams
更多信息：从 PowerShell 连接到 Teams

我们可以使用 PowerShell 连接到 SharePoint Online 网站吗？

是的，您可以使用 SharePoint Online Management Shell 连接到 SharePoint Online。详细信息：如何使用 PowerShell 连接到 SharePoint Online？