Partilhar via

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

  • Artigo

APLICA-SE A:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint 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 utilizador interage com um item no seu site, o SharePoint Server gera um evento de utilização para esta 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 "Planear a análise de utilização, eventos de utilização e recomendações" em Planear a pesquisa de sites de publicação entre sites 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

Existem três tipos de eventos de utilização predefinidos no SharePoint Server. Pode criar até 12 tipos de eventos de utilização personalizada com 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.

  • Grupos de administradores no servidor no qual está a executar 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 não tiver permissões, contacte o administrador de Configuração ou o administrador do SQL Server para pedir permissões. Para obter mais informações sobre as permissões do PowerShell, veja Add-SPShellAdmin.

  1. Inicie o Shell de Gerenciamento do SharePoint.

  2. 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 pretende criar um evento de utilização personalizada.

  • <EventTypeName> é o nome do novo tipo de evento de utilização personalizada que pretende 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.

Observação

Recomendamos que você use o Windows PowerShell ao executar tarefas administrativas de linha de comando. A ferramenta de linha de comando Stsadm está obsoleta, mas está incluída para oferecer suporte à compatibilidade com versões anteriores do produto.

Gravar um evento de uso personalizado

Depois de criar um tipo de evento de utilização personalizada, conforme descrito em Criar um tipo de evento de utilização personalizada, tem de adicionar código ao local onde o evento ocorre, por exemplo, quando uma página é carregada ou quando um utilizador clica numa ligação ou num botão. Em seguida, estes dados são enviados para o componente de processamento de análise, onde são registados e processados.

Se estiver a utilizar a publicação entre sites, onde mostra conteúdo de catálogo num site de publicação, tem de registar o evento de utilização no URL do item indexado e substituir algumas definiçõ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.

  • Grupos de administradores no servidor no qual está a executar 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 não tiver permissões, contacte o administrador de Configuração ou o administrador do SQL Server para pedir permissões. Para obter mais informações sobre as permissões do PowerShell, veja Add-SPShellAdmin.

  1. Inicie o Shell de Gerenciamento do SharePoint.

  2. 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
  1. Num editor de HTML, abra o ficheiro onde o evento de utilização personalizada deve ser registado, por exemplo, um modelo de apresentação para uma Peça Web 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 é o ID numérico do tipo de evento de utilização , por exemplo, 4e605543-63cf-4b5f-aab6-99a10b8fb257.

  1. 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> é o URL completo do item para o qual o evento de utilização deve ser registado, 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.

  • Grupos de administradores no servidor no qual está a executar 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 não tiver permissões, contacte o administrador de Configuração ou o administrador do SQL Server para pedir permissões. Para obter mais informações sobre as permissões do PowerShell, veja Add-SPShellAdmin.

  1. Inicie o Shell de Gerenciamento do SharePoint.

  2. 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
  1. Num editor de HTML, abra o ficheiro onde o evento de utilização personalizada deve ser registado, por exemplo, um modelo de apresentação para uma Peça Web 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> é o ID numérico do tipo de evento de utilização , por exemplo, 4e605543-63cf-4b5f-aab6-99a10b8fb257 .

  1. 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> é o URL encontrado na propriedade gerida OriginalPath.

  • <O GUID> do SiteId é o GUID do 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> de WebId é o GUID do 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.

  • <UserName> pode ser um ID de cookie que é utilizado para identificar utilizadores num site que tenha utilizadores anónimos.

Gravar um evento de uso padrão

Se quiser adicionar código que se refira a um tipo de evento de utilização predefinido, por exemplo, vistas, tem de adicionar código ao local onde o evento ocorre.

Se estiver a utilizar a publicação entre sites, que mostra o conteúdo do catálogo num site de publicação, tem de registar o evento de utilização no URL do item indexado e substituir algumas definiçõ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.

  • Grupos de administradores no servidor no qual está a executar 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 não tiver permissões, contacte o administrador de Configuração ou o administrador do SQL Server para pedir permissões. Para obter mais informações sobre as permissões do PowerShell, veja Add-SPShellAdmin.

  1. Inicie o Shell de Gerenciamento do SharePoint.

  2. 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
  1. Num editor de HTML, abra o ficheiro onde o evento de utilização personalizada deve ser registado, por exemplo, um modelo de apresentação para uma Peça Web 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 utilização predefinido, por exemplo Vistas.

  • <EventTypeId> é o ID numérico do tipo de evento de utilização , por exemplo, 1.

  1. 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 utilização predefinido, por exemplo Views .

  • <URL> é o URL completo do item para o qual o evento de utilização deve ser registado, por exemplo, https://contoso.com/careers.

  1. 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.

  • Grupos de administradores no servidor no qual está a executar 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 não tiver permissões, contacte o administrador de Configuração ou o administrador do SQL Server para pedir permissões. Para obter mais informações sobre as permissões do PowerShell, veja Add-SPShellAdmin.

  1. Inicie o Shell de Gerenciamento do SharePoint.

  2. 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
  1. Num editor de HTML, abra o ficheiro onde o evento de utilização personalizada deve ser registado, por exemplo, um modelo de apresentação para uma Peça Web pesquisa de conteúdo. O exemplo abaixo mostra como substituir o SiteId atual, o WebId e o 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");
}

Onde:

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

  • <EventTypeId> é o ID numérico do tipo de evento de utilização, por exemplo, 1 .

  1. 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 predefinido, por exemplo Views .

  • <URL> é o URL na propriedade gerida OriginalPath.

  • <O GUID> do SiteId é o GUID do 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> de WebId é o GUID do 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.

  • <UserName> pode ser um ID de cookie que é utilizado para identificar utilizadores num site que tem utilizadores anónimos, por exemplo.

Observação

Recomendamos que você use o Windows PowerShell ao executar tarefas administrativas de linha de comando. A ferramenta de linha de comando Stsadm está obsoleta, mas está incluída para oferecer suporte à compatibilidade com versões anteriores do produto.

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 utilização de Vistas predefinido 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.

  • Grupos de administradores no servidor no qual está a executar 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 não tiver permissões, contacte o administrador de Configuração ou o administrador do SQL Server para pedir permissões. Para obter mais informações sobre as permissões do PowerShell, veja Add-SPShellAdmin.

  1. Inicie o Shell de Gerenciamento do SharePoint.

  2. 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> é o ID numérico do tipo de evento de utilização para o qual pretende alterar a ponderação, por exemplo, 256.

  • <RecommendationWeightNumber> é o nível de importância que pretende aplicar ao tipo de evento do utilizador, por exemplo, 4.

Observação

Recomendamos que você use o Windows PowerShell ao executar tarefas administrativas de linha de comando. A ferramenta de linha de comando Stsadm está obsoleta, mas está incluída para oferecer suporte à compatibilidade com versões anteriores do produto.

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

A propriedade de tipo de evento de utilização RecentPopularityTimeframe é um valor numérico que define o período de tempo Recente no relatório Itens Mais Populares . O relatório Itens Mais Populares mostra os itens mais populares por tipo de evento de utilização para todos os itens numa biblioteca ou lista, por exemplo, os itens mais visualizados numa biblioteca ou lista. O relatório pode ser ordenado pelos períodos de tempo Recentes ou Nunca. Por predefinição, o Período de tempo recente está definido para os últimos 14 dias para cada evento de utilização. Pode alterar este valor para um período de tempo entre um e 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.

  • Grupos de administradores no servidor no qual está a executar 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 as permissões do PowerShell, veja Add-SPShellAdmin.

  1. Inicie o Shell de Gerenciamento do SharePoint.

  2. 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> é o ID numérico do tipo de evento de utilização para o qual pretende alterar o período de tempo Recente , por exemplo, 256.

  • <TimeFrame> é o novo período de tempo recente que pretende aplicar ao tipo de evento do utilizador, 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.

Observação

Recomendamos que você use o Windows PowerShell ao executar tarefas administrativas de linha de comando. A ferramenta de linha de comando Stsadm está obsoleta, mas está incluída para oferecer suporte à compatibilidade com versões anteriores do produto.

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.

  • Grupos de administradores no servidor no qual está a executar 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 não tiver permissões, contacte o administrador de Configuração ou o administrador do SQL Server para pedir permissões. Para obter mais informações sobre as permissões do PowerShell, veja Add-SPShellAdmin.

  1. Inicie o Shell de Gerenciamento do SharePoint.

  2. 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> é o ID numérico do tipo de evento de utilização que pretende ativar para o registo de utilizadores 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.

  • Grupos de administradores no servidor no qual está a executar 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 as permissões do PowerShell, veja Add-SPShellAdmin.

  1. Inicie o Shell de Gerenciamento do SharePoint.

  2. 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> é o ID numérico do tipo de evento de utilização que pretende desativar para o registo de utilizadores anónimos, por exemplo, 256.

    Observação

    Para o tipo de evento de utilização predefinido Vistas , não pode desativar o registo de utilizadores anónimos.

Observação

Recomendamos que você use o Windows PowerShell ao executar tarefas administrativas de linha de comando. A ferramenta de linha de comando Stsadm está obsoleta, mas está incluída para oferecer suporte à compatibilidade com versões anteriores do produto.

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.

  • Grupos de administradores no servidor no qual está a executar 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 as permissões do PowerShell, veja Add-SPShellAdmin.

  1. Inicie o Shell de Gerenciamento do SharePoint.

  2. 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> é o URL do site de raiz que pretende obter o GUID do SiteId e o GUID do WebId de, por exemplo, https://contoso.com/sites/catalog.

  • <SubSiteLocation> é o resto do caminho do URL para o subsite após o URL do site raiz. Por exemplo, se o URL do site raiz for https://contoso.com/sites/catalog e o URL do subsite for https://contoso.com/sites/catalog/products, escreva produtos para este marcador de posição.

Observação

Recomendamos que você use o Windows PowerShell ao executar tarefas administrativas de linha de comando. A ferramenta de linha de comando Stsadm está obsoleta, mas está incluída para oferecer suporte à compatibilidade com versões anteriores do produto.

Confira também

Conceitos

Exibir relatórios de uso no SharePoint Server

Outros recursos

Como apresentar recomendações e itens populares num site do SharePoint Server 2013