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

**上一次修改主题：**2017-09-11

使用事件，您可以跟踪用户如何与您的网站上的项目进行交互。项可以是文档、 网站或目录项。当用户与您的网站上的项目交互时， SharePoint Server生成此操作是使用事件。例如，如果您想要监视的目录项来自移动电话的查看频率，您可以跟踪此活动。

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

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

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

本文内容：

• 创建自定义使用事件类型

• 记录自定义使用事件

• 记录默认使用事件

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

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

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

• 为网站获取 SiteId GUID 和 WebId GUID

创建自定义使用事件类型

在SharePoint Server中有三个默认使用的事件类型。通过使用Microsoft PowerShell，可以创建多达十二个自定义使用的事件类型。

若要创建自定义的使用事件类型

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

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

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

   • 运行 PowerShell cmdlet 的服务器上的 Administrators 组。

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

   管理员可使用 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 "https://localhost"
   
   # To get a site below the root site collection level:
   $Site = Get-SPSite "https://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 定时服务。

记录自定义使用事件

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

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

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

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

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

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

   • 运行 PowerShell cmdlet 的服务器上的 Administrators 组。

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

   管理员可使用 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 的服务器上的 Administrators 组。

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

   管理员可使用 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 的服务器上的 Administrators 组。

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

   管理员可使用 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 的服务器上的 Administrators 组。

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

   管理员可使用 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。

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

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

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

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

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

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

   • 运行 PowerShell cmdlet 的服务器上的 Administrators 组。

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

   管理员可使用 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。

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

使用事件类型属性 RecentPopularityTimeframe 是一个数值，该数值定义&quot;最受欢迎的项目&quot;报告中的&quot;最近&quot;时间段。&quot;最受欢迎的项目&quot;报告按照使用事件类型显示库或列表中所有项目的最受欢迎的项目（例如，库或列表中查看次数最多的项目）。该报告可按时间段&quot;最近&quot;或&quot;曾经&quot;进行排序。默认情况下，&quot;最近&quot;时间段将设置为每种使用事件的最近 14 天。您可以将其更改为一个介于 1 天和 14 天之间的时间段。

若要更改使用事件类型的最新时间段

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

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

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

   • 运行 PowerShell cmdlet 的服务器上的 Administrators 组。

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

   管理员可使用 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> 是您要更改其&quot;最近&quot;时间段的使用事件类型的数值 ID，例如，256。

   • <TimeFrame> 是您要应用到用户事件类型的新&quot;最近&quot;时间段，例如，7。

   备注

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

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

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

若要启用匿名用户的使用事件日志

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

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

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

   • 运行 PowerShell cmdlet 的服务器上的 Administrators 组。

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

   管理员可使用 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 的服务器上的 Administrators 组。

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

   管理员可使用 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。

   备注

   对于默认使用事件类型&quot;查看次数&quot;，您不能禁用匿名用户的日志记录。

获取站点的站点 Id 的 GUID 和 WebId GUID

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

若要获取站点的站点 Id 的 GUID 和 WebId GUID

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

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

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

   • 运行 PowerShell cmdlet 的服务器上的 Administrators 组。

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

   管理员可使用 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*，则在占位符处键入 products。

See also

在 SharePoint 服务器中查看使用率报告

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