Настройка рекомендаций и типов событий использования в SharePoint Server

 

**Применимо к:**SharePoint Server 2013, SharePoint Server 2016

**Последнее изменение раздела:**2017-09-11

События использования позволяют отслеживать взаимодействия пользователей с элементами на вашем сайте. Элементы может быть документы, сайты и элементы каталога. Когда пользователь взаимодействует с элементом веб-узла, SharePoint Server приводит к возникновению события использования этого действия. Например если вы хотите отслеживать, как часто отображаются элементы каталога с мобильного телефона, можно отслеживать действия.

В этой статье описывается, как создавать настраиваемые типы событий использования и как добавлять код для записи настраиваемых событий использования, чтобы их можно было обрабатывать с помощью компонента обработки аналитики.

Вы можете использовать данные, созданные событиями использования, для отображения на сайте рекомендаций или популярных элементов. В этой статье также описывается, как повлиять на отображение рекомендаций путем изменения уровня важности для определенного типа событий использования. Дополнительные сведения см. в подразделе "Планирование анализа использования, событий использования и рекомендаций" раздела Планирование поиска в сайтах публикации на нескольких сайтах в SharePoint Server 2016.

Вы можете просмотреть статистику по всем типам событий использования в отчетах "Тренды популярности" и "Самые популярные элементы". Дополнительные сведения см. в разделе Просмотр отчетов об использовании в SharePoint Server.

В этой статье

  • Создание настраиваемого типа событий использования

  • Запись настраиваемого события использования

  • Запись события использования по умолчанию

  • Изменение уровня важности для типа событий использования

  • Изменение периода времени, в течение которого событие использования считается недавним

  • Включение и отключение ведения журнала событий использования для анонимных пользователей

  • Получение SiteId GUID и WebId GUID для сайта

Создание настраиваемого типа событий использования

Существует три типа события использования по умолчанию в SharePoint Server. Можно создать до 12 настраиваемые типы событий использования с помощью Microsoft PowerShell.

Создание настраиваемого типа событий использования

  1. Убедитесь, что предоставлены следующие разрешения.

    • Предопределенная роль сервера securityadmin для экземпляра SQL Server.

    • Предопределенная роль базы данных db_owner во всех базах данных, которые должны обновляться.

    • Группа администраторов для сервера, на котором выполняются командлеты PowerShell.

    • Добавьте участие в группах, необходимое помимо приведенных выше минимальных требований.

    Администратор может использовать командлет Add-SPShellAdmin для предоставления разрешений на использование командлетов SharePoint Server.

    Примечание

    Если у вас нет разрешений, обратитесь к администратору установки или администратору 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. Используйте его при добавлении кода для записи настраиваемого события использования, как описывается в подразделе Запись настраиваемого события использования.

    Важно!

    Чтобы настраиваемый тип событий использования стал доступен в системе, может потребоваться до трех часов. Однако, чтобы ускорить этот процесс, вы можете перезапустить службу таймера SharePoint.

Примечание

Для выполнения административных задач из командной строки мы рекомендуем использовать Windows PowerShell. Программа командной строки Stsadm является устаревшей, однако она добавлена для совместимости с предыдущими версиями продукта.

Запись настраиваемого события использования

После создания настраиваемого типа событий использования, как описано в подразделе Создание настраиваемого типа событий использования, вам нужно добавить код в то место, где происходит событие, например загрузка страницы, переход по ссылке или нажатие кнопки. Данные события затем передаются в компонент обработки аналитики, где они регистрируются и обрабатываются.

Если вы используете публикацию на нескольких сайтах, при которой содержимое каталога отображается на сайте публикации, вам нужно регистрировать событие использования по URL-адресу индексированного элемента и переопределить некоторые параметры сайта. Например, если у вас есть каталог на сайте среды разработки, который вы опубликовали на сайте публикации, то когда пользователь взаимодействует с элементом каталога на сайте публикации, событие использования должно регистрироваться для объекта на сайте среды разработки. Кроме того, код, который вы добавили для регистрации события использования, должен переопределять идентификаторы SiteId и WebId сайта публикации и заменять их на соответствующие идентификаторы сайта среды разработки.

Добавление кода для записи настраиваемого события использования

  1. Убедитесь, что предоставлены следующие разрешения.

    • Предопределенная роль сервера securityadmin для экземпляра SQL Server.

    • Предопределенная роль базы данных db_owner во всех базах данных, которые должны обновляться.

    • Группа администраторов для сервера, на котором выполняются командлеты PowerShell.

    • Добавьте участие в группах, необходимое помимо приведенных выше минимальных требований.

    Администратор может использовать командлет Add-SPShellAdmin для предоставления разрешений на использование командлетов SharePoint Server.

    Примечание

    Если у вас нет разрешений, обратитесь к администратору установки или администратору 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 откройте файл, в котором должно быть зарегистрировано нестандартное событие использования, например шаблон отображения для веб-части поиска контента, и добавьте следующий код:

    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> — это числовой идентификатор типа события использования, например 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. Убедитесь, что предоставлены следующие разрешения.

    • Предопределенная роль сервера securityadmin для экземпляра SQL Server.

    • Предопределенная роль базы данных db_owner во всех базах данных, которые должны обновляться.

    • Группа администраторов для сервера, на котором выполняются командлеты PowerShell.

    • Добавьте участие в группах, необходимое помимо приведенных выше минимальных требований.

    Администратор может использовать командлет Add-SPShellAdmin для предоставления разрешений на использование командлетов SharePoint Server.

    Примечание

    Если у вас нет разрешений, обратитесь к администратору установки или администратору 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 откройте файл, в котором должно быть зарегистрировано настраиваемое событие использования, например шаблон отображения для веб-части поиска контента. В следующем примере показано, как переопределить текущие значения 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> — это числовой идентификатор типа события использования, например 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> — это URL-адрес, указанный в управляемом свойстве OriginalPath.

    • <SiteId GUID> — это SiteId GUID сайта разработки. Подробнее о том, как получить SiteId GUID, см. в разделе Получение SiteId GUID и WebId GUID для сайта.

    • <WebId GUID> — это WebId GUID сайта разработки. Подробнее о том, как получить WebId GUID, см. в разделе Получение SiteId GUID и WebId GUID для сайта.

    • <UserName> может представлять собой идентификатор файла cookie, используемый для идентификации пользователей на сайте, на котором есть анонимные пользователи.

Запись события использования по умолчанию

Если вы хотите добавить код, связанный с типом событий использования по умолчанию, например просмотрами, это нужно сделать в том месте, где происходит событие.

Если вы используете публикацию на нескольких сайтах, при которой содержимое каталога отображается на сайте публикации, вам нужно регистрировать событие использования по URL-адресу индексированного элемента и переопределить некоторые параметры сайта. Например, если у вас есть каталог на сайте среды разработки, который вы опубликовали на сайте публикации, то когда пользователь взаимодействует с элементом каталога на сайте публикации, событие использования должно регистрироваться для объекта на сайте среды разработки. Кроме того, код, который вы добавили для регистрации события использования, должен переопределять идентификаторы SiteId и WebId сайта публикации и заменять их на соответствующие идентификаторы сайта среды разработки.

Добавление кода для записи события использования по умолчанию

  1. Убедитесь, что предоставлены следующие разрешения.

    • Предопределенная роль сервера securityadmin для экземпляра SQL Server.

    • Предопределенная роль базы данных db_owner во всех базах данных, которые должны обновляться.

    • Группа администраторов для сервера, на котором выполняются командлеты PowerShell.

    • Добавьте участие в группах, необходимое помимо приведенных выше минимальных требований.

    Администратор может использовать командлет Add-SPShellAdmin для предоставления разрешений на использование командлетов SharePoint Server.

    Примечание

    Если у вас нет разрешений, обратитесь к администратору установки или администратору 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 откройте файл, в котором должно быть зарегистрировано нестандартное событие использования, например шаблон отображения для веб-части поиска контента, и добавьте следующий код:

    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> — это числовой идентификатор типа события использования, например 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. Убедитесь, что предоставлены следующие разрешения.

    • Предопределенная роль сервера securityadmin для экземпляра SQL Server.

    • Предопределенная роль базы данных db_owner во всех базах данных, которые должны обновляться.

    • Группа администраторов для сервера, на котором выполняются командлеты PowerShell.

    • Добавьте участие в группах, необходимое помимо приведенных выше минимальных требований.

    Администратор может использовать командлет Add-SPShellAdmin для предоставления разрешений на использование командлетов SharePoint Server.

    Примечание

    Если у вас нет разрешений, обратитесь к администратору установки или администратору 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 откройте файл, в котором должно быть зарегистрировано настраиваемое событие использования, например шаблон отображения для веб-части поиска контента. В следующем примере показано, как переопределить текущие значения 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> — это числовой идентификатор типа события использования, например 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> — это URL-адрес в управляемом свойстве OriginalPath.

    • <SiteId GUID> — это SiteId GUID сайта разработки. Подробнее о том, как получить SiteId GUID, см. в разделе Получение SiteId GUID и WebId GUID для сайта.

    • <WebId GUID> — это WebId GUID сайта разработки. Подробнее о том, как получить WebId GUID, см. в разделе Получение SiteId GUID и WebId GUID для сайта.

    • <UserName> может представлять собой, например, идентификатор файла cookie, используемый для идентификации пользователей на сайте, на котором есть анонимные пользователи.

Примечание

Для выполнения административных задач из командной строки мы рекомендуем использовать Windows PowerShell. Программа командной строки Stsadm является устаревшей, однако она добавлена для совместимости с предыдущими версиями продукта.

Изменение уровня важности для типа событий использования

Свойство RecommendationWeight типа событий использования имеет числовое значение, указывающее на уровень важности этого типа событий относительно других типов, используемых при вычислении рекомендаций. Для типа событий использования Просмотры свойство RecommendationWeight имеет предварительно настроенное значение 1. Другие типы событий использования по умолчанию, Отображение рекомендаций и Переходы по рекомендациям, а также все настраиваемые типы событий имеют значение 0 для свойства RecommendationWeight. Чтобы повысить важность типа событий использования при вычислении рекомендаций, измените значение параметра RecommendationWeight. Максимальный уровень важности равен 10.

Изменение уровня важности для типа событий использования

  1. Убедитесь, что предоставлены следующие разрешения.

    • Предопределенная роль сервера securityadmin для экземпляра SQL Server.

    • Предопределенная роль базы данных db_owner во всех базах данных, которые должны обновляться.

    • Группа администраторов для сервера, на котором выполняются командлеты PowerShell.

    • Добавьте участие в группах, необходимое помимо приведенных выше минимальных требований.

    Администратор может использовать командлет Add-SPShellAdmin для предоставления разрешений на использование командлетов SharePoint Server.

    Примечание

    Если у вас нет разрешений, обратитесь к администратору установки или администратору 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> — это числовой идентификатор типа событий использования, для которого вы хотите изменить вес, например 256.

    • <RecommendationWeightNumber> — это уровень важности, который вы хотите применить к пользовательскому типу событий, например 4.

Примечание

Для выполнения административных задач из командной строки мы рекомендуем использовать Windows PowerShell. Программа командной строки Stsadm является устаревшей, однако она добавлена для совместимости с предыдущими версиями продукта.

Изменение периода времени, в течение которого событие использования считается недавним

Свойство RecentPopularityTimeframe типа событий использования имеет числовое значение, определяющее период времени Последние в отчете Самые популярные элементы. В этом отчете показаны самые популярные элементы в библиотеке или списке по типам событий использования, например наиболее часто просматриваемые элементы. Отчет можно отсортировать по периоду времени — Последние или Всегда. По умолчанию период времени "Последние" для каждого события использования — последние 14 дней. Вы можете изменить его в пределах от одного до 14 дней.

Чтобы изменить последние промежуток времени для типа событий использования

  1. Убедитесь, что предоставлены следующие разрешения.

    • Предопределенная роль сервера securityadmin для экземпляра SQL Server.

    • Предопределенная роль базы данных db_owner во всех базах данных, которые должны обновляться.

    • Группа администраторов для сервера, на котором выполняются командлеты PowerShell.

    • Добавьте участие в группах, необходимое помимо приведенных выше минимальных требований.

    Администратор может использовать командлет Add-SPShellAdmin для предоставления разрешений на использование командлетов SharePoint Server.

    Примечание

    Если у вас нет разрешений, обратитесь к администратору установки или администратору 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> — это числовой идентификатор типа событий использования, для которого вы хотите изменить период Последние, например 256.

    • <TimeFrame> — это новый период Последние, который вы хотите применить для пользовательского типа событий, например 7.

    Примечание

    Изменения периода "Последние" применяются системой только после запуска задачи таймера "Аналитика использования".

Примечание

Для выполнения административных задач из командной строки мы рекомендуем использовать Windows PowerShell. Программа командной строки Stsadm является устаревшей, однако она добавлена для совместимости с предыдущими версиями продукта.

Включение и отключение ведения журнала событий использования для анонимных пользователей

Пользователи, которые просматривают содержимое сайта, не подключившись к учетной записи, называются анонимными. Для таких пользователей доступно ведение журнала событий только типа Просмотры. По умолчанию ведение журнала настраиваемых событий использования для анонимных пользователей отключено.

Чтобы включить ведение журнала событий использования для анонимных пользователей

  1. Убедитесь, что предоставлены следующие разрешения.

    • Предопределенная роль сервера securityadmin для экземпляра SQL Server.

    • Предопределенная роль базы данных db_owner во всех базах данных, которые должны обновляться.

    • Группа администраторов для сервера, на котором выполняются командлеты PowerShell.

    • Добавьте участие в группах, необходимое помимо приведенных выше минимальных требований.

    Администратор может использовать командлет Add-SPShellAdmin для предоставления разрешений на использование командлетов SharePoint Server.

    Примечание

    Если у вас нет разрешений, обратитесь к администратору установки или администратору 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> — это числовой идентификатор типа событий использования, которые необходимо записывать в журнал для анонимных пользователей, например 256.

Чтобы отключить ведение журнала событий использования для анонимных пользователей

  1. Убедитесь, что предоставлены следующие разрешения.

    • Предопределенная роль сервера securityadmin для экземпляра SQL Server.

    • Предопределенная роль базы данных db_owner во всех базах данных, которые должны обновляться.

    • Группа администраторов для сервера, на котором выполняются командлеты PowerShell.

    • Добавьте участие в группах, необходимое помимо приведенных выше минимальных требований.

    Администратор может использовать командлет Add-SPShellAdmin для предоставления разрешений на использование командлетов SharePoint Server.

    Примечание

    Если у вас нет разрешений, обратитесь к администратору установки или администратору 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> — это числовой идентификатор типа событий использования, которые не нужно записывать в журнал для анонимных пользователей, например 256.

    Примечание

    Отключить запись в журнал событий использования типа Просмотры для анонимных пользователей невозможно.

Примечание

Для выполнения административных задач из командной строки мы рекомендуем использовать Windows PowerShell. Программа командной строки Stsadm является устаревшей, однако она добавлена для совместимости с предыдущими версиями продукта.

Получение SiteId GUID и WebId GUID для сайта

Чтобы получить SiteId GUID и WebId GUID, можно использовать следующие команды PowerShell.

Чтобы получить SiteId GUID и WebId GUID для сайта

  1. Убедитесь, что предоставлены следующие разрешения.

    • Предопределенная роль сервера securityadmin для экземпляра SQL Server.

    • Предопределенная роль базы данных db_owner во всех базах данных, которые должны обновляться.

    • Группа администраторов для сервера, на котором выполняются командлеты PowerShell.

    • Добавьте участие в группах, необходимое помимо приведенных выше минимальных требований.

    Администратор может использовать командлет Add-SPShellAdmin для предоставления разрешений на использование командлетов SharePoint Server.

    Примечание

    Если у вас нет разрешений, обратитесь к администратору установки или администратору 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> — это URL-адрес корневого сайта, для которого необходимо получить SiteId GUID и WebId GUID, например https://contoso.com/sites/catalog.

    • <SubSiteLocation> — это остальная часть URL-пути к дочернему сайту, указываемая после URL-адреса корневого сайта. Например, если корневой узел имеет URL-адрес https://contoso.com/sites/catalog, а дочерний — https://contoso.com/sites/catalog/products, введите products для этого заполнителя.

Примечание

Для выполнения административных задач из командной строки мы рекомендуем использовать Windows PowerShell. Программа командной строки Stsadm является устаревшей, однако она добавлена для совместимости с предыдущими версиями продукта.

See also

Просмотр отчетов об использовании в SharePoint Server

Отображение рекомендаций и популярных элементов на сайте SharePoint Server 2013