在 SharePoint Server 2013 中配置建議和使用率事件類型

時間 2019-11-24

標籤 sharepoint server 配置建議使用事件類型欄目 Java開源简体版

原文原文鏈接

http://technet.microsoft.com/zh-cn/library/jj715889.aspxweb

適用於： SharePoint Server 2013 數據庫

利用使用事件，您能夠跟蹤用戶與您網站上的項目進行交互的方式。項目能夠是文檔、網站或目錄項。當用戶與您網站上的項目進行交互時，SharePoint Server 2013 會爲此操做生成一個使用事件。例如，若是您要監控用移動電話查看一個目錄項的頻率，則能夠跟蹤此活動。瀏覽器

本文介紹如何建立自定義使用事件類型，以及如何添加代碼以記錄自定義使用事件以便它們可以由分析處理組件進行處理。服務器

您可使用由使用事件生成的數據來顯示建議或您網站上的受歡迎的項目。本文還介紹如何經過更改特定使用事件類型的重要性級別來影響建議的顯示方式。有關詳細信息，請參閱規劃 SharePoint Server 2013 中跨網站發佈網站的搜索中的「規劃使用率分析、使用事件和建議」。編輯器

您能夠在「熱門程度趨勢」報告和「最受歡迎的項目」報告中查看全部使用事件類型的統計信息。有關詳細信息，請參閱在 SharePoint Server 2013 中查看使用狀況報告。工具

本文內容：網站

開始以前

注意：

由於 SharePoint 2013 在 Internet Information Services (IIS) 中做爲網站運行，因此管理員和用戶依賴於瀏覽器提供的輔助功能。SharePoint 2013 支持受支持的瀏覽器的輔助功能。有關詳細信息，請參閱如下資源：

建立自定義使用事件類型

SharePoint 2013 中有三種默認使用事件類型。您可以使用 Windows PowerShell 建立最多 12 種自定義使用事件類型。

建立自定義使用事件類型

確認您具備如下成員身份：
- SQL Server 實例上的 securityadmin 固定服務器角色。
- 要更新的全部數據庫上的 db_owner 固定數據庫角色。
- 運行 Windows PowerShell cmdlet 的服務器上的 Administrators 組。
- 添加至少具備以上最小權限的成員。
管理員可使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint 2013 cmdlet 的權限。

注意：

若是您不具備相關權限，請聯繫您的安裝管理員或 SQL Server 管理員來請求權限。有關 Windows PowerShell 權限的其餘信息，請參閱 Add-SPShellAdmin。
啓動 SharePoint 2013 Management Shell。
- 對於 Windows Server 2008 R2：
  - 在「開始」菜單上，單擊「全部程序」，單擊「Microsoft SharePoint 2013 產品」，而後單擊「SharePoint 2013 Management Shell」。
- 對於 Windows Server 2012：
  - 在「開始」屏幕上，單擊「SharePoint 2013 Management Shell」。
    
    若是「SharePoint 2013 Management Shell」不在「開始」屏幕上：
  - 右鍵單擊「計算機」，單擊「全部應用程序」，而後單擊「SharePoint 2013 Management Shell」。
有關如何與 Windows Server 2012 進行交互的詳細信息，請參閱Windows Server 2012 中的常見管理任務和導航。
在 Windows 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 替換。

添加用於記錄自定義使用事件的代碼

確認您具備如下成員身份：
- SQL Server 實例上的 securityadmin 固定服務器角色。
- 要更新的全部數據庫上的 db_owner 固定數據庫角色。
- 運行 Windows PowerShell cmdlet 的服務器上的 Administrators 組。
- 添加至少具備以上最小權限的成員。
管理員可使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint 2013 cmdlet 的權限。

注意：

若是您不具備相關權限，請聯繫您的安裝管理員或 SQL Server 管理員來請求權限。有關 Windows PowerShell 權限的其餘信息，請參閱 Add-SPShellAdmin。
啓動 SharePoint 2013 Management Shell。
- 對於 Windows Server 2008 R2：
  - 在「開始」菜單上，單擊「全部程序」，單擊「Microsoft SharePoint 2013 產品」，而後單擊「SharePoint 2013 Management Shell」。
- 對於 Windows Server 2012：
  - 在「開始」屏幕上，單擊「SharePoint 2013 Management Shell」。
    
    若是「SharePoint 2013 Management Shell」不在「開始」屏幕上：
  - 右鍵單擊「計算機」，單擊「全部應用程序」，而後單擊「SharePoint 2013 Management Shell」。
有關如何與 Windows Server 2012 進行交互的詳細信息，請參閱Windows Server 2012 中的常見管理任務和導航。

在 Windows PowerShell 命令提示符處，鍵入如下命令：

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

在 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");
}Where:

<CustomUsageEventType> 是自定義事件的名稱，例如，BuyEventType。
<GUID> 是使用事件類型的數字 ID - 例如，4e605543-63cf-4b5f-aab6-99a10b8fb257。

在 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，例如，http://contoso.com/faq。

添加用於記錄自定義使用事件的代碼並覆蓋網站設置

確認您具備如下成員身份：
- SQL Server 實例上的 securityadmin 固定服務器角色。
- 要更新的全部數據庫上的 db_owner 固定數據庫角色。
- 運行 Windows PowerShell cmdlet 的服務器上的 Administrators 組。
- 添加至少具備以上最小權限的成員。
管理員可使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint 2013 cmdlet 的權限。

注意：

若是您不具備相關權限，請聯繫您的安裝管理員或 SQL Server 管理員來請求權限。有關 Windows PowerShell 權限的其餘信息，請參閱 Add-SPShellAdmin。
啓動 SharePoint 2013 Management Shell。
- 對於 Windows Server 2008 R2：
  - 在「開始」菜單上，單擊「全部程序」，單擊「Microsoft SharePoint 2013 產品」，而後單擊「SharePoint 2013 Management Shell」。
- 對於 Windows Server 2012：
  - 在「開始」屏幕上，單擊「SharePoint 2013 Management Shell」。
    
    若是「SharePoint 2013 Management Shell」不在「開始」屏幕上：
  - 右鍵單擊「計算機」，單擊「全部應用程序」，而後單擊「SharePoint 2013 Management Shell」。
有關如何與 Windows Server 2012 進行交互的詳細信息，請參閱Windows Server 2012 中的常見管理任務和導航。

在 Windows PowerShell 命令提示符處，鍵入如下命令：

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

在 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。

在 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。
- <WebId GUID> 是託管屬性 WebId 的 GUID。
- <UserName> - 例如，能夠是用於標識具備匿名用戶的網站上的用戶的 Cookie ID。

注意：

咱們建議您在執行命令行管理任務時使用 Windows PowerShell。Stsadm 命令行工具已被棄用，仍然包含該工具是爲了支持與以前產品版本的兼容性。

記錄默認使用事件

若要添加引用默認使用事件類型（例如，視圖）的代碼，您必須將代碼添加到事件的發生位置。

添加代碼以記錄默認使用事件

確認您具備如下成員身份：
- SQL Server 實例上的 securityadmin 固定服務器角色。
- 要更新的全部數據庫上的 db_owner 固定數據庫角色。
- 運行 Windows PowerShell cmdlet 的服務器上的 Administrators 組。
- 添加至少具備以上最小權限的成員。
管理員可使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint 2013 cmdlet 的權限。

注意：

若是您不具備相關權限，請聯繫您的安裝管理員或 SQL Server 管理員來請求權限。有關 Windows PowerShell 權限的其餘信息，請參閱 Add-SPShellAdmin。
啓動 SharePoint 2013 Management Shell。
- 對於 Windows Server 2008 R2：
  - 在「開始」菜單上，單擊「全部程序」，單擊「Microsoft SharePoint 2013 產品」，而後單擊「SharePoint 2013 Management Shell」。
- 對於 Windows Server 2012：
  - 在「開始」屏幕上，單擊「SharePoint 2013 Management Shell」。
    
    若是「SharePoint 2013 Management Shell」不在「開始」屏幕上：
  - 右鍵單擊「計算機」，單擊「全部應用程序」，而後單擊「SharePoint 2013 Management Shell」。
有關如何與 Windows Server 2012 進行交互的詳細信息，請參閱Windows Server 2012 中的常見管理任務和導航。

在 Windows PowerShell 命令提示符處，鍵入如下命令：

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

在 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。

在 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，例如，http://contoso.com/careers。
保存該文件。

添加用於記錄默認使用事件的代碼並覆蓋網站設置

確認您具備如下成員身份：
- SQL Server 實例上的 securityadmin 固定服務器角色。
- 要更新的全部數據庫上的 db_owner 固定數據庫角色。
- 運行 Windows PowerShell cmdlet 的服務器上的 Administrators 組。
- 添加至少具備以上最小權限的成員。
管理員可使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint 2013 cmdlet 的權限。

注意：

若是您不具備相關權限，請聯繫您的安裝管理員或 SQL Server 管理員來請求權限。有關 Windows PowerShell 權限的其餘信息，請參閱 Add-SPShellAdmin。
啓動 SharePoint 2013 Management Shell。
- 對於 Windows Server 2008 R2：
  - 在「開始」菜單上，單擊「全部程序」，單擊「Microsoft SharePoint 2013 產品」，而後單擊「SharePoint 2013 Management Shell」。
- 對於 Windows Server 2012：
  - 在「開始」屏幕上，單擊「SharePoint 2013 Management Shell」。
    
    若是「SharePoint 2013 Management Shell」不在「開始」屏幕上：
  - 右鍵單擊「計算機」，單擊「全部應用程序」，而後單擊「SharePoint 2013 Management Shell」。
有關如何與 Windows Server 2012 進行交互的詳細信息，請參閱Windows Server 2012 中的常見管理任務和導航。

在 Windows PowerShell 命令提示符處，鍵入如下命令：

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

在 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。

在 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。
- <WebId GUID> 是託管屬性 WebId 的 GUID。
- <UserName> - 例如，能夠是用於標識具備匿名用戶的網站上的用戶的 Cookie ID。

注意：

咱們建議您在執行命令行管理任務時使用 Windows PowerShell。Stsadm 命令行工具已被棄用，仍然包含該工具是爲了支持與以前產品版本的兼容性。

更改使用事件類型的重要性級別

使用事件類型屬性 RecommendationWeight 是一個數值，該數值顯示某個使用事件類型相對於建議計算中使用的其餘使用事件類型的重要性級別。默認查看次數使用事件類型具備的預配置的 RecommendationWeight 值爲 1。其餘默認使用事件類型（顯示的建議和點擊的建議）以及全部自定義使用事件類型具備的 RecommendationWeight 值爲 0。若要提升建議計算中的使用事件類型的重要性，請更改 RecommendationWeight 參數的值。可用的最高重要性級別爲 10。

更改使用事件類型的重要性級別

確認您具備如下成員身份：
- SQL Server 實例上的 securityadmin 固定服務器角色。
- 要更新的全部數據庫上的 db_owner 固定數據庫角色。
- 運行 Windows PowerShell cmdlet 的服務器上的 Administrators 組。
- 添加至少具備以上最小權限的成員。
管理員可使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint 2013 cmdlet 的權限。

注意：

若是您不具備相關權限，請聯繫您的安裝管理員或 SQL Server 管理員來請求權限。有關 Windows PowerShell 權限的其餘信息，請參閱 Add-SPShellAdmin。
啓動 SharePoint 2013 Management Shell。
- 對於 Windows Server 2008 R2：
  - 在「開始」菜單上，單擊「全部程序」，單擊「Microsoft SharePoint 2013 產品」，而後單擊「SharePoint 2013 Management Shell」。
- 對於 Windows Server 2012：
  - 在「開始」屏幕上，單擊「SharePoint 2013 Management Shell」。
    
    若是「SharePoint 2013 Management Shell」不在「開始」屏幕上：
  - 右鍵單擊「計算機」，單擊「全部應用程序」，而後單擊「SharePoint 2013 Management Shell」。
有關如何與 Windows Server 2012 進行交互的詳細信息，請參閱Windows Server 2012 中的常見管理任務和導航。

在 Windows 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 是一個數值，該數值定義「最受歡迎的項目」報告中的「最近」時間段。「最受歡迎的項目」報告按照使用事件類型顯示庫或列表中全部項目的最受歡迎的項目（例如，庫或列表中查看次數最多的項目）。該報告可按時間段「最近」或「曾經」進行排序。默認狀況下，「最近」時間段將設置爲每種使用事件的最近 14 天。您能夠將其更改成一個介於 1 天和 14 天之間的時間段。

更改使用事件類型的「最近」時間段

確認您具備如下成員身份：
- SQL Server 實例上的 securityadmin 固定服務器角色。
- 要更新的全部數據庫上的 db_owner 固定數據庫角色。
- 運行 Windows PowerShell cmdlet 的服務器上的 Administrators 組。
- 添加至少具備以上最小權限的成員。
管理員可使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint 2013 cmdlet 的權限。

注意：

若是您不具備相關權限，請聯繫您的安裝管理員或 SQL Server 管理員來請求權限。有關 Windows PowerShell 權限的其餘信息，請參閱 Add-SPShellAdmin。
啓動 SharePoint 2013 Management Shell。
- 對於 Windows Server 2008 R2：
  - 在「開始」菜單上，單擊「全部程序」，單擊「Microsoft SharePoint 2013 產品」，而後單擊「SharePoint 2013 Management Shell」。
- 對於 Windows Server 2012：
  - 在「開始」屏幕上，單擊「SharePoint 2013 Management Shell」。
    
    若是「SharePoint 2013 Management Shell」不在「開始」屏幕上：
  - 右鍵單擊「計算機」，單擊「全部應用程序」，而後單擊「SharePoint 2013 Management Shell」。
有關如何與 Windows Server 2012 進行交互的詳細信息，請參閱Windows Server 2012 中的常見管理任務和導航。

在 Windows 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 命令行工具已被棄用，仍然包含該工具是爲了支持與以前產品版本的兼容性。

啓用和禁用匿名用戶的使用事件日誌記錄

在未鏈接到賬戶的狀況下瀏覽網站內容的用戶稱做「匿名用戶」。僅爲匿名用戶的日誌記錄啓用「查看次數」事件類型。默認狀況下，將爲匿名用戶禁用自定義使用事件的日誌記錄。

啓用匿名用戶的使用事件日誌記錄

確認您具備如下成員身份：
- SQL Server 實例上的 securityadmin 固定服務器角色。
- 要更新的全部數據庫上的 db_owner 固定數據庫角色。
- 運行 Windows PowerShell cmdlet 的服務器上的 Administrators 組。
- 添加至少具備以上最小權限的成員。
管理員可使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint 2013 cmdlet 的權限。

注意：

若是您不具備相關權限，請聯繫您的安裝管理員或 SQL Server 管理員來請求權限。有關 Windows PowerShell 權限的其餘信息，請參閱 Add-SPShellAdmin。
啓動 SharePoint 2013 Management Shell。
- 對於 Windows Server 2008 R2：
  - 在「開始」菜單上，單擊「全部程序」，單擊「Microsoft SharePoint 2013 產品」，而後單擊「SharePoint 2013 Management Shell」。
- 對於 Windows Server 2012：
  - 在「開始」屏幕上，單擊「SharePoint 2013 Management Shell」。
    
    若是「SharePoint 2013 Management Shell」不在「開始」屏幕上：
  - 右鍵單擊「計算機」，單擊「全部應用程序」，而後單擊「SharePoint 2013 Management Shell」。
有關如何與 Windows Server 2012 進行交互的詳細信息，請參閱Windows Server 2012 中的常見管理任務和導航。

在 Windows 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。

禁用匿名用戶的使用事件日誌記錄

確認您具備如下成員身份：
- SQL Server 實例上的 securityadmin 固定服務器角色。
- 要更新的全部數據庫上的 db_owner 固定數據庫角色。
- 運行 Windows PowerShell cmdlet 的服務器上的 Administrators 組。
- 添加至少具備以上最小權限的成員。
管理員可使用 Add-SPShellAdmin cmdlet 授予使用 SharePoint 2013 cmdlet 的權限。

注意：

若是您不具備相關權限，請聯繫您的安裝管理員或 SQL Server 管理員來請求權限。有關 Windows PowerShell 權限的其餘信息，請參閱 Add-SPShellAdmin。
啓動 SharePoint 2013 Management Shell。
- 對於 Windows Server 2008 R2：
  - 在「開始」菜單上，單擊「全部程序」，單擊「Microsoft SharePoint 2013 產品」，而後單擊「SharePoint 2013 Management Shell」。
- 對於 Windows Server 2012：
  - 在「開始」屏幕上，單擊「SharePoint 2013 Management Shell」。
    
    若是「SharePoint 2013 Management Shell」不在「開始」屏幕上：
  - 右鍵單擊「計算機」，單擊「全部應用程序」，而後單擊「SharePoint 2013 Management Shell」。
有關如何與 Windows Server 2012 進行交互的詳細信息，請參閱Windows Server 2012 中的常見管理任務和導航。

在 Windows 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([Gui

其中：