Configurar recomendações e tipos de evento de uso no SharePoint Server

APLICA-SE A2013 2016 2019 Subscription Edition SharePoint no Microsoft 365

Eventos de uso permitem que você rastreie como os usuários interagem com itens no seu site. Os itens podem ser documentos, sites ou itens de catálogo. Quando um usuário interage com um item em seu site, o SharePoint Server gera um evento de uso para essa ação. Por exemplo, se você quiser monitorar a frequência em que um item de catálogo é visualizado em um telefone celular, você pode rastrear esta atividade.

Este artigo descreve como criar tipos de evento de uso personalizado e como adicionar código de registro aos eventos de uso personalizados para que eles possam ser processados pelo componente de processamento de análise.

Você pode usar os dados gerados pelos eventos de uso para mostrar recomendações ou itens populares no seu site. Este artigo explica também como influenciar a forma como as recomendações são exibidas ao alterar o nível de importância para um tipo de evento de uso específico. Para obter mais informações, consulte "Planejar análises de uso, eventos de uso e recomendações" em Planejar a pesquisa de sites de publicação intersite no SharePoint Server 2016.

Você pode visualizar as estatísticas para todos os tipos de evento de uso em relatórios de Tendências de popularidade e Itens mais populares. Para obter mais informações, consulte View usage reports in SharePoint Server.

Criar um tipo de evento de uso personalizado

Há três tipos de evento de uso padrão no SharePoint Server. Você pode criar até 12 tipos de eventos de uso personalizado usando o Microsoft PowerShell.

Para criar um tipo de evento de uso personalizado

1. Verifique se você possui as seguintes associações:

• A função de servidor fixa securityadmin na instância do SQL Server.

• A função de banco de dados fixa db_owner em todos os bancos de dados que devem ser atualizados.

• Grupo de administradores no servidor no qual você está executando os cmdlets do PowerShell.

• Adicione associações que sejam necessárias além dos mínimos acima.

  Um administrador pode usar o cmdlet Add-SPShellAdmin para conceder permissões para usar cmdlets SharePoint Server.

  Observação

  Se você não tiver permissões, entre em contato com o administrador de configuração ou com o administrador do SQL Server para solicitar permissões. Para obter mais informações sobre permissões do PowerShell, consulte Add-SPShellAdmin.

2. Inicie o Shell de Gerenciamento do SharePoint.

3. No prompt de comando do PowerShell, digite o seguinte comando:

# 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)

Onde:

• <SiteName> é o nome do site para o qual você deseja criar um evento de uso personalizado.

• <EventTypeName> é o nome do novo tipo de evento de uso personalizado que você deseja criar — por exemplo, BuyEventType .

  Este procedimento cria um GUID aleatório para o tipo de evento de uso. Utilize este GUID ao adicionar código para gravar o evento de uso personalizado, como descrito em Gravar um evento de uso personalizado.

  Importante

  Pode levar até três horas até que um tipo de evento de uso personalizado torne-se disponível no sistema. Entretanto, para agilizar o processo, você pode de maneira alternativa reiniciar o Serviço de Timer do SharePoint.

Gravar um evento de uso personalizado

Depois de criar um tipo de evento de uso personalizado, conforme descrito em Criar um tipo de evento de uso personalizado, você precisa adicionar código ao local onde o evento ocorre, por exemplo, quando uma página é carregada ou quando um usuário clica em um link ou botão. Esses dados são enviados para o componente de processamento de análise, onde são registrados e processados.

Se estiver usando a publicação intersite, na qual você mostra o conteúdo do catálogo em um site de publicação, deverá registrar o evento de uso na URL do item indexado e substituir algumas configurações do site. Por exemplo, se você tiver um catálogo em um site que você publicou ou em um site de publicação, quando um usuário interagir com um item de catálogo no site de publicação, este evento de uso deverá ser gravado no item no site de autoria. Além disso, o código que você adicionou para gravar o evento de uso deverá substituir o SiteId e WebId do site de publicação e ser substituído com o SiteId e WebId do site de autoria.

Para adicionar código para gravar um evento de uso personalizado

1. Verifique se você possui as seguintes associações:

• A função de servidor fixa securityadmin na instância do SQL Server.

• A função de banco de dados fixa db_owner em todos os bancos de dados que devem ser atualizados.

• Grupo de administradores no servidor no qual você está executando os cmdlets do PowerShell.

• Adicione associações que sejam necessárias além dos mínimos acima.

  Um administrador pode usar o cmdlet Add-SPShellAdmin para conceder permissões para usar cmdlets SharePoint Server.

  Observação

  Se você não tiver permissões, entre em contato com o administrador de configuração ou com o administrador do SQL Server para solicitar permissões. Para obter mais informações sobre permissões do PowerShell, consulte Add-SPShellAdmin.

2. Inicie o Shell de Gerenciamento do SharePoint.

3. No prompt de comando do PowerShell, digite o seguinte comando:

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

4. Em um editor de HTML, abra o arquivo no qual o evento de uso personalizado deve ser registrado — por exemplo, um modelo de exibição para uma Web Part de Pesquisa de Conteúdo e adicione o seguinte código:

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 é o nome do evento personalizado, por exemplo, BuyEventType .

• GUID é a ID numérica do tipo de evento de uso, por exemplo, 4e605543-63cf-4b5f-aab6-99a10b8fb257.

5. Em um editor de HTML, abra o arquivo que se refere ao evento de uso personalizado e adicione o seguinte código:

# 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>

Onde:

• <CustomUsageEventType> é o nome do tipo de evento personalizado.

• <URL> é a URL completa do item no qual o evento de uso deve ser registrado — por exemplo, https://contoso.com/faq.

Para adicionar código para registrar um evento de uso e substituir configurações

1. Verifique se você possui as seguintes associações:

• A função de servidor fixa securityadmin na instância do SQL Server.

• A função de banco de dados fixa db_owner em todos os bancos de dados que devem ser atualizados.

• Grupo de administradores no servidor no qual você está executando os cmdlets do PowerShell.

• Adicione associações que sejam necessárias além dos mínimos acima.

  Um administrador pode usar o cmdlet Add-SPShellAdmin para conceder permissões para usar cmdlets SharePoint Server.

  Observação

  Se você não tiver permissões, entre em contato com o administrador de configuração ou com o administrador do SQL Server para solicitar permissões. Para obter mais informações sobre permissões do PowerShell, consulte Add-SPShellAdmin.

2. Inicie o Shell de Gerenciamento do SharePoint.

3. No prompt de comando do PowerShell, digite o seguinte comando:

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

4. Em um editor de HTML, abra o arquivo no qual o evento de uso personalizado deve ser registrado — por exemplo, um modelo de exibição para uma Web Part de Pesquisa de Conteúdo. O exemplo a seguir mostra como substituir o SiteId, WebId e UserId atuais.

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

Onde:

• <CustomUsageEventType> é o nome do tipo de evento personalizado, por exemplo, BuyEventType .

• <GUID> é a ID numérica do tipo de evento de uso, por exemplo, 4e605543-63cf-4b5f-aab6-99a10b8fb257 .

5. Em um editor de HTML, abra o arquivo que se refere ao evento de uso personalizado e adicione o seguinte código::

# 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>

Onde:

• <CustomUsageEventType> é o nome do tipo de evento personalizado, por exemplo, BuyEventType.

• <URL> é a URL encontrada na propriedade gerenciada OriginalPath.

• <O GUID> de SiteId é o GUID de SiteId do site de criação. Para obter informações sobre como obter o GUID de SiteId, consulte Obter GUID de SiteId e GUID de WebId de um site.

• <O GUID> da WebId é o GUID da WebId do site de criação. Para obter informações sobre como obter o GUID de WebId, consulte Obter GUID de SiteId e GUID de WebId de um site.

• <Nome de> usuário pode ser uma ID de cookie usada para identificar usuários em um site que tem usuários anônimos.

Gravar um evento de uso padrão

Se você quiser adicionar código que se refira a um tipo de evento de uso padrão — por exemplo, modos de exibição, você precisará adicionar código ao local onde o evento ocorre.

Se estiver usando a publicação intersite, que mostra o conteúdo do catálogo em um site de publicação, você deverá registrar o evento de uso na URL do item indexado e substituir algumas configurações do site. pro exemplo, se você possui um catálogo em um site autoral publicado em um site de publicação, quando um usuário interagir com um item de catálogo no site de publicação, este evento de uso será registrado no item no site autoral. Além disso, o código que você adicionar para gravar o evento de uso deve substituir o SiteId e WebId do site de publicação e ser substituído pelo SiteId e WebId do site autoral.

Para adicionar código para gravar um evento de uso padrão

1. Verifique se você possui as seguintes associações:

• A função de servidor fixa securityadmin na instância do SQL Server.

• A função de banco de dados fixa db_owner em todos os bancos de dados que devem ser atualizados.

• Grupo de administradores no servidor no qual você está executando os cmdlets do PowerShell.

• Adicione associações que sejam necessárias além dos mínimos acima.

  Um administrador pode usar o cmdlet Add-SPShellAdmin para conceder permissões para usar cmdlets SharePoint Server.

  Observação

  Se você não tiver permissões, entre em contato com o administrador de configuração ou com o administrador do SQL Server para solicitar permissões. Para obter mais informações sobre permissões do PowerShell, consulte Add-SPShellAdmin.

2. Inicie o Shell de Gerenciamento do SharePoint.

3. No prompt de comando do PowerShell, digite o seguinte comando:

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

4. Em um editor de HTML, abra o arquivo no qual o evento de uso personalizado deve ser registrado — por exemplo, um modelo de exibição para uma Web Part de Pesquisa de Conteúdo e adicione o seguinte código:

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

Onde:

• <DefaultUsageEventType> é o nome do tipo de evento de uso padrão — por exemplo, Exibições.

• <EventTypeId> é a ID numérica do tipo de evento de uso—por exemplo, 1.

5. Em um editor de HTML, abra o arquivo que se refere ao evento de uso padrão e adicione o código a seguir:

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

Onde:

• <DefaultUsageEventType> é o nome do tipo de evento de uso padrão — por exemplo, Views .

• <URL> é a URL completa do item no qual o evento de uso deve ser registrado — por exemplo, https://contoso.com/careers.

6. Salve o arquivo.

Para adicionar código para gravar um evento de uso padrão e substituir configurações de site

1. Verifique se você possui as seguintes associações:

• A função de servidor fixa securityadmin na instância do SQL Server.

• A função de banco de dados fixa db_owner em todos os bancos de dados que devem ser atualizados.

• Grupo de administradores no servidor no qual você está executando os cmdlets do PowerShell.

• Adicione associações que sejam necessárias além dos mínimos acima.

  Um administrador pode usar o cmdlet Add-SPShellAdmin para conceder permissões para usar cmdlets SharePoint Server.

  Observação

  Se você não tiver permissões, entre em contato com o administrador de configuração ou com o administrador do SQL Server para solicitar permissões. Para obter mais informações sobre permissões do PowerShell, consulte Add-SPShellAdmin.

2. Inicie o Shell de Gerenciamento do SharePoint.

3. No prompt de comando do PowerShell, digite o seguinte comando:

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

4. Em um editor de HTML, abra o arquivo no qual o evento de uso personalizado deve ser registrado — por exemplo, um modelo de exibição para uma Web Part de Pesquisa de Conteúdo. O exemplo a seguir mostra como substituir a SiteId, a WebId e a UserId atuais.

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

Onde:

• <DefaultUsageEventType> é o nome do tipo de evento padrão, por exemplo, Views .

• <EventTypeId> é a ID numérica do tipo de evento de uso—por exemplo, 1 .

5. Em um editor de HTML, abra o arquivo que se refere ao tipo de evento de uso padrão e adicione o código a seguir:

# 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>')">

Onde:

• <DefaultUsageEventType> é o nome do tipo de evento padrão, por exemplo, Views .

• <URL> é a URL na propriedade gerenciada OriginalPath.

• <O GUID> de SiteId é o GUID de SiteId do site de criação. Para obter informações sobre como obter o GUID de SiteId, consulte Obter GUID de SiteId e GUID de WebId de um site.

• <O GUID> da WebId é o GUID da WebId do site de criação. Para obter informações sobre como obter o GUID de WebId, consulte Obter GUID de SiteId e GUID de WebId de um site.

• < > Nome de usuário pode ser uma ID de cookie usada para identificar usuários em um site que tem usuários anônimos, por exemplo.

Alterar o nível de importância de um tipo de evento de uso

A propriedade de tipo de evento de uso, RecommendationWeight, é um valor numérico que exibe o nível de importância de um tipo de evento de uso comparado a outros tipos de evento de uso que são utilizados no cálculo das recomendações. O tipo de evento de uso padrão de Views tem um valor RecommendationWeight pré-configurado de 1. Os outros tipos de evento de uso padrão, Recomendações exibidas e Recomendações clicadas, e todos os tipos de evento de uso padrão possuem um valor RecommendationWeight de 0. Para aumentar a importância de um tipo de evento de uso em um cálculo de recomendações, altere o valor do parâmetro RecommendationWeight. O nível mais alto de importância disponível é 10.

Para alterar o nível de importância de um tipo de evento de uso

1. Verifique se você possui as seguintes associações:

• A função de servidor fixa securityadmin na instância do SQL Server.

• A função de banco de dados fixa db_owner em todos os bancos de dados que devem ser atualizados.

• Grupo de administradores no servidor no qual você está executando os cmdlets do PowerShell.

• Adicione associações que sejam necessárias além dos mínimos acima.

  Um administrador pode usar o cmdlet Add-SPShellAdmin para conceder permissões para usar cmdlets SharePoint Server.

  Observação

  Se você não tiver permissões, entre em contato com o administrador de configuração ou com o administrador do SQL Server para solicitar permissões. Para obter mais informações sobre permissões do PowerShell, consulte Add-SPShellAdmin.

2. Inicie o Shell de Gerenciamento do SharePoint.

3. No prompt de comando do PowerShell, digite o seguinte comando:

# 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

Onde:

• <EventTypeId> é a ID numérica do tipo de evento de uso para o qual você deseja alterar o peso — por exemplo, 256.

• <RecommendationWeightNumber> é o nível de importância que você deseja aplicar ao tipo de evento do usuário — por exemplo, 4.

Alterar o período de tempo Recente para um tipo de evento de uso

A propriedade de tipo de evento de uso RecentPopularityTimeframe é um valor numérico que define o período de tempo recente no relatório de Itens Mais Populares . O relatório Itens Mais Populares mostra os itens mais populares por tipo de evento de uso para todos os itens em uma biblioteca ou lista — por exemplo, os itens mais exibidos em uma biblioteca ou lista. O relatório pode ser classificado pelos períodos de tempo, Recente ou Nunca. Por padrão, o período de tempo recente é definido como os últimos 14 dias para cada evento de uso. Você pode alterar esse valor para um período de um a 14 dias.

Para alterar o período de tempo Recente para um tipo de evento de uso

1. Verifique se você possui as seguintes associações:

• A função de servidor fixa securityadmin na instância do SQL Server.

• A função de banco de dados fixa db_owner em todos os bancos de dados que devem ser atualizados.

• Grupo de administradores no servidor no qual você está executando os cmdlets do PowerShell.

• Adicione associações que sejam necessárias além dos mínimos acima.

  Um administrador pode usar o cmdlet Add-SPShellAdmin para conceder permissões para usar cmdlets SharePoint Server.

  Observação

  Se você não possui permissões, entre em contato com seu administrador de Configuração ou o administrador do SQL Server para solicitar permissões. Para obter mais informações sobre permissões do PowerShell, consulte Add-SPShellAdmin.

2. Inicie o Shell de Gerenciamento do SharePoint.

3. No prompt de comando do PowerShell, digite o seguinte comando:

# 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

Onde:

• <EventTypeId> é a ID numérica do tipo de evento de uso para o qual você deseja alterar o período de tempo recente — por exemplo, 256.

• <TimeFrame> é o novo período de tempo recente que você deseja aplicar ao tipo de evento do usuário — por exemplo, 7.

  Observação

  O sistema atualiza quaisquer alterações ao período de tempo Recente apenas depois que o Trabalho de Timer de Análise de Uso tiver sido executado.

Ativar e desativar o registro de eventos de uso de usuários anônimos

Usuários que estão navegando pelos conteúdos de um site sem estarem conectados a uma conta são conhecidos como usuários anônimos. Apenas o tipo de evento Visualizações está ativo para logon de usuários anônimos. Por padrão, o registro de log de eventos de uso personalizado está desativado para usuários anônimos.

Para ativar e desativar o registro de eventos de uso de usuários anônimos

1. Verifique se você possui as seguintes associações:

• A função de servidor fixa securityadmin na instância do SQL Server.

• A função de banco de dados fixa db_owner em todos os bancos de dados que devem ser atualizados.

• Grupo de administradores no servidor no qual você está executando os cmdlets do PowerShell.

• Adicione associações que sejam necessárias além dos mínimos acima.

  Um administrador pode usar o cmdlet Add-SPShellAdmin para conceder permissões para usar cmdlets SharePoint Server.

  Observação

  Se você não tiver permissões, entre em contato com o administrador de configuração ou com o administrador do SQL Server para solicitar permissões. Para obter mais informações sobre permissões do PowerShell, consulte Add-SPShellAdmin.

2. Inicie o Shell de Gerenciamento do SharePoint.

3. No prompt de comando do PowerShell, digite o seguinte comando:

# 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

Onde:

• <EventTypeId> é a ID numérica do tipo de evento de uso que você deseja habilitar para o registro em log de usuários anônimos — por exemplo, 256.

Para ativar e desativar o registro de eventos de uso de usuários anônimos

1. Verifique se você possui as seguintes associações:

• A função de servidor fixa securityadmin na instância do SQL Server.

• A função de banco de dados fixa db_owner em todos os bancos de dados que devem ser atualizados.

• Grupo de administradores no servidor no qual você está executando os cmdlets do PowerShell.

• Adicione associações que sejam necessárias além dos mínimos acima.

  Um administrador pode usar o cmdlet Add-SPShellAdmin para conceder permissões para usar cmdlets SharePoint Server.

  Observação

  Se você não possui permissões, entre em contato com seu administrador de Configuração ou o administrador do SQL Server para solicitar permissões. Para obter mais informações sobre permissões do PowerShell, consulte Add-SPShellAdmin.

2. Inicie o Shell de Gerenciamento do SharePoint.

3. No prompt de comando do PowerShell, digite o seguinte comando:

# 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)

Onde:

• <EventTypeId> é a ID numérica do tipo de evento de uso que você deseja desabilitar para o registro de usuários anônimos — por exemplo, 256.

  Observação

  Para o tipo de evento de uso padrão Exibições , não é possível desabilitar o registro de usuários anônimos.

Obter GUID de SiteId e GUID de WebId de um site

Você pode usar os seguintes comandos do PowerShell para obter o GUID de SiteId e o GUID de WebId de um site.

Para obter o GUID de SiteId e o GUID de WebId de um site

1. Verifique se você possui as seguintes associações:

• A função de servidor fixa securityadmin na instância do SQL Server.

• A função de banco de dados fixa db_owner em todos os bancos de dados que devem ser atualizados.

• Grupo de administradores no servidor no qual você está executando os cmdlets do PowerShell.

• Adicione associações que sejam necessárias além dos mínimos acima.

  Um administrador pode usar o cmdlet Add-SPShellAdmin para conceder permissões para usar cmdlets SharePoint Server.

  Observação

  Se você não possui permissões, entre em contato com seu administrador de Configuração ou o administrador do SQL Server para solicitar permissões. Para obter mais informações sobre permissões do PowerShell, consulte Add-SPShellAdmin.

2. Inicie o Shell de Gerenciamento do SharePoint.

3. No prompt de comando do PowerShell, digite o seguinte comando:

# 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

Onde:

• <RootSiteURL> é a URL do site raiz que você deseja obter o GUID de SiteId e o GUID de WebId de, por exemplo, https://contoso.com/sites/catalog.

• <SubSiteLocation> é o restante do caminho da URL para o subsite após a URL do site raiz. Por exemplo, se a URL do site raiz for https://contoso.com/sites/catalog e a URL do subsite for https://contoso.com/sites/catalog/products, digite produtos para esse espaço reservado.

Confira também

Conceitos

Exibir relatórios de uso no SharePoint Server

Outros recursos

Como exibir recomendações e itens populares em um site do SharePoint Server 2013