在 SharePoint 服务器上配置的建议和使用事件类型

适用于：2013 2016 2019 Subscription Edition SharePoint in Microsoft 365

Usage events enable you to track how users interact with items on your site. Items can be documents, sites, or catalog items. 当用户与网站上的项目交互时，SharePoint Server 会生成此操作的使用事件。 For example, if you want to monitor how often a catalog item is viewed from a mobile phone, you can track this activity.

本文介绍如何创建自定义使用事件类型，以及如何添加代码以记录自定义使用事件以便它们能够由分析处理组件进行处理。

您可以使用由使用事件生成的数据来显示建议或您网站上的受欢迎的项目。 本文还介绍如何通过更改特定使用事件类型的重要性级别来影响建议的显示方式。 有关详细信息，请参阅 在 SharePoint Server 2016 中规划跨网站发布网站的搜索中的“计划使用情况分析、使用情况事件和建议”。

您可以在"热门程度趋势"报告和"最受欢迎的项目"报告中查看所有使用事件类型的统计信息。 有关详细信息，请参阅View usage reports in SharePoint Server。

创建自定义使用事件类型

SharePoint Server 中有三种默认使用情况事件类型。 可以使用 Microsoft PowerShell 创建最多 12 种自定义使用事件类型。

创建自定义使用情况事件类型

1. 确认您具有以下成员身份：

• SQL Server 实例上的 securityadmin 固定服务器角色。

• 要更新的所有数据库上的 db_owner 固定数据库角色。

• 运行 PowerShell cmdlet 的服务器上的管理员组。

• 添加至少具有以上最小权限的成员。

  管理员可以使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint Server cmdlet 的权限。

  注意

  如果没有权限，请与安装程序管理员或 SQL Server 管理员联系以请求权限。 有关 PowerShell 权限的详细信息，请参阅 Add-SPShellAdmin。

2. 启动 SharePoint 命令行管理程序。

3. 在 PowerShell 命令提示符处，键入以下命令：

# To get a site at the root site collection level:
$Site = Get-SPSite "http://localhost"
# To get a site below the root site collection level:
$Site = Get-SPSite "http://localhost/sites/<SiteName>"
# To create a custom usage event type:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$EventGuid = [Guid]::NewGuid()
$EventName = "<EventTypeName>"
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$newEventType = $tenantConfig.RegisterEventType($EventGuid, $EventName, "")
$tenantConfig.Update($SSP)

其中：

• <SiteName> 是要为其创建自定义使用事件的网站的名称。

• <EventTypeName> 是要创建的新自定义使用事件类型的名称，例如 BuyEventType 。

  此过程将为使用事件类型创建一个随机 GUID。 添加代码时使用此 GUID 可记录自定义使用事件，如记录自定义使用事件中所述。

  重要

  自定义使用事件类型至多可能要等待三个小时才在系统中可用。 但是，要加速此过程，您也可以重新启动 SharePoint 定时服务。

注意

[!注意] 我们建议您在执行命令行管理任务时使用 Windows PowerShell。 Stsadm 命令行工具已被弃用，仍然包含该工具是为了支持与之前产品版本的兼容性。

记录自定义使用事件

创建自定义使用情况事件类型（如 创建自定义使用情况事件类型中所述）后，必须向事件发生的位置添加代码（例如，页面加载时或用户单击链接或按钮时）。 然后，此数据将发送到分析处理组件，并在其中进行记录和处理。

如果使用跨网站发布，在发布网站上显示目录内容，则必须在索引项的 URL 上记录使用情况事件，并替代某些网站设置。 例如，如果您的已在发布网站上发布的创作网站中有一个目录，则当用户与发布网站上的目录项交互时，此使用事件必须记录到创作网站中的该项目上。 此外，您添加的用于记录使用事件的代码必须覆盖发布网站的 SiteId 和 WebId，并由创作网站的 SiteId 和 WebId 替换。

添加代码以记录自定义使用情况事件

1. 确认您具有以下成员身份：

• SQL Server 实例上的 securityadmin 固定服务器角色。

• 要更新的所有数据库上的 db_owner 固定数据库角色。

• 运行 PowerShell cmdlet 的服务器上的管理员组。

• 添加至少具有以上最小权限的成员。

  管理员可以使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint Server cmdlet 的权限。

  注意

  如果没有权限，请与安装程序管理员或 SQL Server 管理员联系以请求权限。 有关 PowerShell 权限的详细信息，请参阅 Add-SPShellAdmin。

2. 启动 SharePoint 命令行管理程序。

3. 在 PowerShell 命令提示符处，键入以下命令：

# To view GUIDs for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

4. 在 HTML 编辑器中，打开应记录自定义使用事件的文件（例如，内容搜索 Web 部件的显示模板），并添加以下代码：

window.Log<CustomUsageEventType>ToEventStore = function(url)
{
    ExecuteOrDelayUntilScriptLoaded(function()
    {
        var spClientContext = SP.ClientContext.get_current();
        var eventGuid = new SP.Guid("<GUID>");
        SP.Analytics.AnalyticsUsageEntry.logAnalyticsAppEvent(spClientContext, eventGuid, url);
        spClientContext.executeQueryAsync(null, Function.createDelegate(this, function(sender, e){ alert("Failed to log event for item: " + document.URL + " due to: " + e.get_message()) }));
    }, "SP.js");
}

• CustomUsageEventType 是自定义事件的名称，例如 BuyEventType 。

• GUID 是使用情况事件类型的数字 ID，例如 4e605543-63cf-4b5f-aab6-99a10b8fb257。

5. 在 HTML 编辑器中，打开引用自定义使用事件的文件，并添加以下代码：

# The example below shows how a custom usage event type is referred to when a button is clicked: 
<button onclick="Log<CustomUsageEventType>ToEventStore('<URL>')"></button>

其中：

• <CustomUsageEventType> 是自定义事件类型的名称。

• <URL> 是应将使用情况事件记录到的项的完整 URL， https://contoso.com/faq例如 。

添加代码以记录自定义使用情况事件并替代网站设置

1. 确认您具有以下成员身份：

• SQL Server 实例上的 securityadmin 固定服务器角色。

• 要更新的所有数据库上的 db_owner 固定数据库角色。

• 运行 PowerShell cmdlet 的服务器上的管理员组。

• 添加至少具有以上最小权限的成员。

  管理员可以使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint Server cmdlet 的权限。

  注意

  如果没有权限，请与安装程序管理员或 SQL Server 管理员联系以请求权限。 有关 PowerShell 权限的详细信息，请参阅 Add-SPShellAdmin。

2. 启动 SharePoint 命令行管理程序。

3. 在 PowerShell 命令提示符处，键入以下命令：

# To view GUIDs for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

4. 在 HTML 编辑器中，打开应记录自定义使用事件的文件，例如内容搜索 Web 部件的显示模板。 以下示例显示如何覆盖当前 SiteId、WebId 和 UserId。

window.Log<CustomUsageEventType>ToEventStore = function(url, siteIdGuid, webIdGuid, spUser)
{
    ExecuteOrDelayUntilScriptLoaded(function()
    {
      var spClientContext = SP.ClientContext.get_current();
      var eventGuid = new SP.Guid("<GUID>");
SP.Analytics.AnalyticsUsageEntry.logAnalyticsAppEvent2(spClientContext, eventGuid, url, webIdGuid, siteIdGuid, spUser);
      spClientContext.executeQueryAsync(null, Function.createDelegate(this, function(sender, e){ alert("Failed to log event for item: " + document.URL + " due to: " + e.get_message()) }));
    }, "SP.js");
}

其中：

• <CustomUsageEventType> 是自定义事件类型的名称，例如 BuyEventType 。

• <GUID> 是使用情况事件类型的数字 ID，例如 4e605543-63cf-4b5f-aab6-99a10b8fb257 。

5. 在 HTML 编辑器中，打开引用自定义使用事件类型的文件，并添加以下代码：

# The example below shows how a custom usage event type is referred to when the "Buy!" button is clicked:
<button onclick="Log<CustomUsageEventType>ToEventStore('<URL>', new SP.Guid('{<SiteId GUID>}'), new SP.Guid('{<WebId GUID>}'), '<UserName>')">Buy!</button>

其中：

• <CustomUsageEventType> 是自定义事件类型的名称，例如 BuyEventType。

• <URL> 是在托管属性 OriginalPath 中找到的 URL。

• <SiteId GUID> 是创作网站的 SiteId GUID。 有关如何获取 SiteId GUID 的信息，请参阅为网站获取 SiteId GUID 和 WebId GUID。

• <WebId GUID> 是创作网站的 WebId GUID。 有关如何获取 WebId GUID 的信息，请参阅为网站获取 SiteId GUID 和 WebId GUID。

• <UserName> 可以是用于标识具有匿名用户的网站上的用户的 Cookie ID。

记录默认使用事件

如果要添加引用默认使用情况事件类型的代码（例如视图），则必须将代码添加到事件发生的位置。

如果使用跨网站发布（在发布网站上显示目录内容），则必须在索引项的 URL 上记录使用事件，并替代某些网站设置。 例如，如果您的已在发布网站上发布的创作网站中有一个目录，则当用户与发布网站上的目录项交互时，此使用事件必须记录到创作网站中的该项目上。 此外，您添加的用于记录使用事件的代码必须覆盖发布网站的 SiteId 和 WebId，并由创作网站的 SiteId 和 WebId 替换。

添加代码以记录默认使用事件

1. 确认您具有以下成员身份：

• SQL Server 实例上的 securityadmin 固定服务器角色。

• 要更新的所有数据库上的 db_owner 固定数据库角色。

• 运行 PowerShell cmdlet 的服务器上的管理员组。

• 添加至少具有以上最小权限的成员。

  管理员可以使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint Server cmdlet 的权限。

  注意

  如果没有权限，请与安装程序管理员或 SQL Server 管理员联系以请求权限。 有关 PowerShell 权限的详细信息，请参阅 Add-SPShellAdmin。

2. 启动 SharePoint 命令行管理程序。

3. 在 PowerShell 命令提示符处，键入以下命令：

# To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

4. 在 HTML 编辑器中，打开应记录自定义使用事件的文件（例如，内容搜索 Web 部件的显示模板），并添加以下代码：

window.Log<DefaultUsageEventType>ToEventStore = function(url)
{
    ExecuteOrDelayUntilScriptLoaded(function()
    {
        var spClientContext = SP.ClientContext.get_current();
        SP.Analytics.AnalyticsUsageEntry.logAnalyticsEvent(spClientContext, <EventTypeId>, url);
        spClientContext.executeQueryAsync(null, Function.createDelegate(this, function(sender, e){ alert("Failed to log event for item: " + document.URL + " due to: " + e.get_message()) }));
    }, "SP.js");
}

其中：

• <DefaultUsageEventType> 是默认使用事件类型的名称，例如 Views。

• <EventTypeId> 是使用情况事件类型的数字 ID，例如 1。

5. 在 HTML 编辑器中，打开引用默认使用事件的文件，并添加以下代码：

# The example below shows how a default usage event type is referred to on a page load:
<body onload="Log<DefaultUsageEventType>ToEventStore('<URL>')"> 

其中：

• <DefaultUsageEventType> 是默认使用情况事件类型的名称，例如 Views 。

• <URL> 是应将使用情况事件记录到的项的完整 URL， https://contoso.com/careers例如 。

6. 保存文件。

添加代码以记录默认使用事件并替代网站设置

1. 确认您具有以下成员身份：

• SQL Server 实例上的 securityadmin 固定服务器角色。

• 要更新的所有数据库上的 db_owner 固定数据库角色。

• 运行 PowerShell cmdlet 的服务器上的管理员组。

• 添加至少具有以上最小权限的成员。

  管理员可以使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint Server cmdlet 的权限。

  注意

  如果没有权限，请与安装程序管理员或 SQL Server 管理员联系以请求权限。 有关 PowerShell 权限的详细信息，请参阅 Add-SPShellAdmin。

2. 启动 SharePoint 命令行管理程序。

3. 在 PowerShell 命令提示符处，键入以下命令：

# To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

4. 在 HTML 编辑器中，打开应记录自定义使用事件的文件，例如内容搜索 Web 部件的显示模板。 下面的示例演示如何替代当前 SiteId、WebId 和 UserId。

window.Log<DefaultUsageEventType>ToEventStore = function(url, siteIdGuid, webIdGuid, spUser)
{
    ExecuteOrDelayUntilScriptLoaded(function()
    {
      var spClientContext = SP.ClientContext.get_current();
      SP.Analytics.AnalyticsUsageEntry.logAnalyticsEvent(spClientContext, <EventTypeId>, url, webIdGuid, siteIdGuid, spUser);
spClientContext.executeQueryAsync(null, Function.createDelegate(this, function(sender, e){ alert("Failed to log event for item: " + document.URL + " due to: " + e.get_message()) }));
    }, "SP.js");
}

其中：

• <DefaultUsageEventType> 是默认事件类型的名称，例如 Views 。

• <EventTypeId> 是使用情况事件类型的数字 ID，例如 1 。

5. 在 HTML 编辑器中，打开引用默认使用事件类型的文件，并添加以下代码：

# The example below shows how a default usage event type is referred to on a page load:
<body onload="Log<DefaultUsageEventType>ToEventStore('<URL>', new SP.Guid('{<SiteId GUID>}'), new SP.Guid('{<WebId GUID>}'), '<UserName>')">

其中：

• <DefaultUsageEventType> 是默认事件类型的名称，例如 Views 。

• <URL> 是托管属性 OriginalPath 中的 URL。

• <SiteId GUID> 是创作网站的 SiteId GUID。 有关如何获取 SiteId GUID 的信息，请参阅为网站获取 SiteId GUID 和 WebId GUID。

• <WebId GUID> 是创作网站的 WebId GUID。 有关如何获取 WebId GUID 的信息，请参阅为网站获取 SiteId GUID 和 WebId GUID。

• 例如，<UserName> 可以是用于标识具有匿名用户的网站上的用户的 Cookie ID。

注意

[!注意] 我们建议您在执行命令行管理任务时使用 Windows PowerShell。 Stsadm 命令行工具已被弃用，仍然包含该工具是为了支持与之前产品版本的兼容性。

更改使用事件类型的重要性级别

使用事件类型属性 RecommendationWeight 是一个数值，该数值显示某个使用事件类型相对于建议计算中使用的其他使用事件类型的重要性级别。 默认 查看次数使用事件类型具有的预配置的 RecommendationWeight 值为 1。 其他默认使用事件类型（ 显示的建议和 点击的建议）以及所有自定义使用事件类型具有的 RecommendationWeight 值为 0。 若要提高建议计算中的使用事件类型的重要性，请更改 RecommendationWeight 参数的值。 可用的最高重要性级别为 10。

更改使用事件类型的重要性级别

1. 确认您具有以下成员身份：

• SQL Server 实例上的 securityadmin 固定服务器角色。

• 要更新的所有数据库上的 db_owner 固定数据库角色。

• 运行 PowerShell cmdlet 的服务器上的管理员组。

• 添加至少具有以上最小权限的成员。

  管理员可以使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint Server cmdlet 的权限。

  注意

  如果没有权限，请与安装程序管理员或 SQL Server 管理员联系以请求权限。 有关 PowerShell 权限的详细信息，请参阅 Add-SPShellAdmin。

2. 启动 SharePoint 命令行管理程序。

3. 在 PowerShell 命令提示符处，键入以下命令：

# To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft
# To get a usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
# To change the importance level of a usage event type:
$event.RecommendationWeight = <RecommendationWeightNumber>
$tenantConfig.Update($SSP)
# To verify the changed importance level for the usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
$event

其中：

• <EventTypeId> 是要更改其权重的使用情况事件类型的数字 ID，例如 256。

• <RecommendationWeightNumber> 是要应用于用户事件类型的重要性级别，例如 4。

注意

[!注意] 我们建议您在执行命令行管理任务时使用 Windows PowerShell。 Stsadm 命令行工具已被弃用，仍然包含该工具是为了支持与之前产品版本的兼容性。

更改使用事件类型的“最近”时间段

使用事件类型属性 RecentPopularityTimeframe 是一个数值，该数值定义“最受欢迎的项目”报告中的“最近”时间段。 “最常用项”报表显示库或列表中所有项（例如，库或列表中查看次数最多的项目）的每个使用情况事件类型。 The report can be sorted by the time periods Recent or Ever. By default, the Recent time period is set to the last 14 days for each usage event. 可以将此值更改为 1 到 14 天的时间段。

更改使用事件类型的最近时间段

1. 确认您具有以下成员身份：

• SQL Server 实例上的 securityadmin 固定服务器角色。

• 要更新的所有数据库上的 db_owner 固定数据库角色。

• 运行 PowerShell cmdlet 的服务器上的管理员组。

• 添加至少具有以上最小权限的成员。

  管理员可以使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint Server cmdlet 的权限。

  注意

  [!注意] 如果您不具有这些权限，请联系您的安装管理员或 SQL Server 管理员来请求权限。 有关 PowerShell 权限的详细信息，请参阅 Add-SPShellAdmin。

2. 启动 SharePoint 命令行管理程序。

3. 在 PowerShell 命令提示符处，键入以下命令：

# To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft
# To get a usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
# To change the Recent time span for a usage event type:
$event.RecentPopularityTimeFrame = <TimeFrame>
$tenantConfig.Update($SSP)
# To verify the changed Recent time frame for the usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
$event

其中：

• <EventTypeId> 是要更改 最近时间段的使用 事件类型的数字 ID，例如 256。

• <TimeFrame> 是要应用于用户事件类型的新 “最近 ”时间范围，例如 7。

  注意

  系统仅在运行 Usage Analytics 计时器作业后更新对"最近"时间段的任何更改。

注意

[!注意] 我们建议您在执行命令行管理任务时使用 Windows PowerShell。 Stsadm 命令行工具已被弃用，仍然包含该工具是为了支持与之前产品版本的兼容性。

启用和禁用匿名用户的使用事件日志记录

在未连接到帐户的情况下浏览网站内容的用户称作“匿名用户”。 仅为匿名用户的日志记录启用“查看次数”事件类型。 默认情况下，将为匿名用户禁用自定义使用事件的日志记录。

启用匿名用户的使用事件的日志记录

1. 确认您具有以下成员身份：

• SQL Server 实例上的 securityadmin 固定服务器角色。

• 要更新的所有数据库上的 db_owner 固定数据库角色。

• 运行 PowerShell cmdlet 的服务器上的管理员组。

• 添加至少具有以上最小权限的成员。

  管理员可以使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint Server cmdlet 的权限。

  注意

  如果没有权限，请与安装程序管理员或 SQL Server 管理员联系以请求权限。 有关 PowerShell 权限的详细信息，请参阅 Add-SPShellAdmin。

2. 启动 SharePoint 命令行管理程序。

3. 在 PowerShell 命令提示符处，键入以下命令：

# To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft
# To get a usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
# To enable the logging of anonymous users:
$event.Options = [Microsoft.Office.Server.Search.Analytics.EventOptions]::AllowAnonymousWrite
$tenantConfig.Update($SSP)
# To verify that the logging of anonymous users has been enabled, i.e. that the Options property is set to AllowAnonymousWrite:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
$event

其中：

• <EventTypeId> 是要为匿名用户的日志记录启用的使用事件类型的数字 ID，例如 256。

禁用匿名用户的使用事件的日志记录

1. 确认您具有以下成员身份：

• SQL Server 实例上的 securityadmin 固定服务器角色。

• 要更新的所有数据库上的 db_owner 固定数据库角色。

• 运行 PowerShell cmdlet 的服务器上的管理员组。

• 添加至少具有以上最小权限的成员。

  管理员可以使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint Server cmdlet 的权限。

  注意

  [!注意] 如果您不具有这些权限，请联系您的安装管理员或 SQL Server 管理员来请求权限。 有关 PowerShell 权限的详细信息，请参阅 Add-SPShellAdmin。

2. 启动 SharePoint 命令行管理程序。

3. 在 PowerShell 命令提示符处，键入以下命令：

# To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft
# To get a usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
# To disable the logging of anonymous users:
$event.Options = [Microsoft.Office.Server.Search.Analytics.EventOptions]::None
$tenantConfig.Update($SSP)
# To verify that logging of anonymous users has been disabled, i.e. that the Options property is set to None:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)

其中：

• <EventTypeId> 是要为匿名用户的日志记录禁用的使用事件类型的数字 ID，例如 256。

  注意

  对于默认使用情况事件类型 “视图 ”，不能禁用匿名用户的日志记录。

注意

[!注意] 我们建议您在执行命令行管理任务时使用 Windows PowerShell。 Stsadm 命令行工具已被弃用，仍然包含该工具是为了支持与之前产品版本的兼容性。

为网站获取 SiteId GUID 和 WebId GUID

可以使用以下 PowerShell 命令为网站获取 SiteId GUID 和 WebId GUID。

获取站点的 SiteId GUID 和 WebId GUID

1. 确认您具有以下成员身份：

• SQL Server 实例上的 securityadmin 固定服务器角色。

• 要更新的所有数据库上的 db_owner 固定数据库角色。

• 运行 PowerShell cmdlet 的服务器上的管理员组。

• 添加至少具有以上最小权限的成员。

  管理员可以使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint Server cmdlet 的权限。

  注意

  [!注意] 如果您不具有这些权限，请联系您的安装管理员或 SQL Server 管理员来请求权限。 有关 PowerShell 权限的详细信息，请参阅 Add-SPShellAdmin。

2. 启动 SharePoint 命令行管理程序。

3. 在 PowerShell 命令提示符处，键入以下命令：

# To get the SiteId GUID and the WebId GUID for a root site collection:
$site = Get-SPSite "<RootSiteURL>"
$web = $site.RootWeb
$site.id
$web.id
# To get the WebId GUID for a site below the root site collection:
$site = Get-SPSite "<RootSiteURL>"
$web = $site.OpenWeb("<SubSiteLocation>")
$web.id

其中：

• <RootSiteURL> 是要获取的 SiteId GUID 和 WebId GUID 的根网站的 URL， https://contoso.com/sites/catalog例如 。

• <SubSiteLocation> 是根网站 URL 之后子网站的 URL 路径的其余部分。 例如，如果根网站 URL 为 https://contoso.com/sites/catalog ，而子网站 URL 为 https://contoso.com/sites/catalog/products，请为此占位符键入 产品 。

注意

[!注意] 我们建议您在执行命令行管理任务时使用 Windows PowerShell。 Stsadm 命令行工具已被弃用，仍然包含该工具是为了支持与之前产品版本的兼容性。

另请参阅

概念

在 SharePoint Server 中查看使用情况报告

其他资源

How to display recommendations and popular items on a SharePoint Server 2013 site