Configurer des recommandations et des types d’événements de l’utilisation de SharePoint Server

Article
02/23/2018

**Sapplique à :**SharePoint Server 2013, SharePoint Server 2016

**Dernière rubrique modifiée :**2017-09-11

Événements d’utilisation vous permettent de vous permet de suivre la façon dont les utilisateurs interagissent avec les éléments de votre site. Éléments peuvent être des documents, des sites ou des éléments de catalogue. Lorsqu’un utilisateur interagit avec un élément sur votre site, SharePoint Server génère un événement de l’utilisation de cette action. Par exemple, si vous souhaitez contrôler la fréquence à laquelle un élément de catalogue est affiché à partir d’un téléphone portable, vous pouvez suivre cette activité.

Cet article décrit comment créer des types d’événement d’utilisation personnalisé et comment ajouter du code dans le but d’enregistrer des événements d’utilisation personnalisés et permettre leur traitement à l’aide du composant de traitement d’analyse.

Vous pouvez utiliser les données générées par les événements d’utilisation pour afficher des recommandations ou des éléments populaires sur votre site. Cet article explique aussi comment influencer le mode d’affichage des recommandations en modifiant le niveau d’importance d’un type d’événement d’utilisation en particulier. Pour plus d’informations, voir « Planification de l’analyse de l’utilisation, des événements d’utilisation et des recommandations » dans Planification de la recherche pour les sites de publication intersites dans SharePoint Server 2016.

Vous pouvez dévoiler les statistiques de tous les types d’événement d’utilisation dans les rapports Tendances de popularité et Éléments les plus populaires. Pour plus d’informations, voir Affichage des rapports d’utilisation dans SharePoint Server.

Contenu de cet article :

Créer un type d'événement d'utilisation personnalisé
Enregistrer un événement d'utilisation personnalisé
Enregistrer un événement d'utilisation par défaut
Changer le niveau d'importance d'un type d'événement d'utilisation
Modifier le critère de temps Récent pour un type d'événement d'utilisation
Activer et désactiver la journalisation des événements d'utilisation des utilisateurs anonymes
Get SiteId GUID and WebId GUID for a site

Créer un type d’événement d’utilisation personnalisé

Il existe trois types d’événements de l’utilisation par défaut dans SharePoint Server. Vous pouvez créer des types d’événements jusqu'à douze utilisation personnalisée à l’aide de Microsoft PowerShell.

Pour créer un type d’événement utilisation personnalisée

Vérifiez que vous disposez des appartenances suivantes :
- Rôle serveur fixe securityadmin sur l’instance SQL Server
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- Groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell
- Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.
Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder des autorisations d’utilisation des cmdlets SharePoint Server.

Notes

Si vous ne disposez pas des autorisations, contactez votre administrateur d’installation ou votre administrateur SQL Server afin de les demander. Pour plus d’informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Management Shell.
À l’invite de commandes PowerShell, tapez la commande suivante :
```
# 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)
```
Où :
- <SiteName> est le nom du site pour lequel vous souhaitez créer un événement d’utilisation personnalisé.
- <EventTypeName> est le nom du nouveau type d’événement d’utilisation personnalisé que vous cherchez à créer (par exemple, BuyEventType).
Cette procédure crée un GUID au hasard pour le type d’événement d’utilisation personnalisé. Utilisez ce GUID au moment d’ajouter du code pour enregistrer l’événement d’utilisation personnalisé comme le décrit la section Enregistrer un événement d'utilisation personnalisé.

Important

Trois heures maximum peuvent s’écouler avant que le type d’événement d’utilisation ne soit disponible dans le système. Cependant, pour accélérer le processus, vous pouvez également redémarrer le service du minuteur SharePoint.

Notes

Nous vous recommandons d’utiliser Windows PowerShell pour les tâches d’administration en ligne de commande. L’outil en ligne de commande Stsadm a été abandonné, mais il est inclus pour assurer la compatibilité avec les versions précédentes.

Enregistrer un événement d’utilisation personnalisé

Après avoir créé un type d’événement d’utilisation personnalisé (voir la section Créer un type d'événement d'utilisation personnalisé), vous devez ajouter un code à l’endroit même où survient l’événement (par exemple, lors du chargement d’une page ou lorsqu’un utilisateur clique sur un lien ou un bouton). Ces données sont ensuite transmises au composant de traitement d’analyse où elles sont enregistrées et traitées.

Si vous utilisez la publication intersites qui consiste à afficher le contenu d’un catalogue sur un site de publication, vous devez enregistrer l’événement d’utilisation dans l’URL de l’élément indexé et remplacer certains paramètres du site. Par exemple, si vous disposez sur un site de création d’un catalogue que vous avez publié sur un site de publication, quand un utilisateur exploite un élément du catalogue sur le site de publication, cet événement d’utilisation doit être enregistré dans l’élément sur le site de création. De plus, le code que vous ajoutez dans le but d’enregistrer l’événement d’utilisation doit remplacer les propriétés SiteId et WebId du site de publication et accepter à la place les propriétés SiteId et WebId du site de création.

Pour ajouter du code pour enregistrer un événement d’utilisation personnalisée

Vérifiez que vous disposez des appartenances suivantes :
- Rôle serveur fixe securityadmin sur l’instance SQL Server
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- Groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell
- Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.
Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder des autorisations d’utilisation des cmdlets SharePoint Server.

Notes

Si vous ne disposez pas des autorisations, contactez votre administrateur d’installation ou votre administrateur SQL Server afin de les demander. Pour plus d’informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Management Shell.

À l’invite de commandes PowerShell, tapez la commande suivante :

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

Dans un éditeur HTML, ouvrez le fichier dans lequel l’événement d’utilisation personnalisé doit être enregistré (par exemple un modèle d’affichage pour un composant WebPart de recherche de contenu) et ajoutez le code suivant :

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> est le nom de l’événement personnalisé (par exemple, BuyEventType).
<GUID> est l’ID numérique du type d’événement d’utilisation (par exemple, 4e605543-63cf-4b5f-aab6-99a10b8fb257).

Dans un éditeur HTML, ouvrez le fichier qui se rapporte à l’événement d’utilisation personnalisé et ajoutez le code suivant :
```
# 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>
```
Où :
- <CustomUsageEventType> est le nom du type d’événement personnalisé.
- <URL> est l’URL complète de l’élément dans lequel l’événement d’utilisation est à enregistrer (par exemple, https://contoso.com/faq).

Pour ajouter du code pour enregistrer un événement d’utilisation personnalisés et de substituer les paramètres du site

Vérifiez que vous disposez des appartenances suivantes :
- Rôle serveur fixe securityadmin sur l’instance SQL Server
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- Groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell
- Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.
Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder des autorisations d’utilisation des cmdlets SharePoint Server.

Notes

Si vous ne disposez pas des autorisations, contactez votre administrateur d’installation ou votre administrateur SQL Server afin de les demander. Pour plus d’informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Management Shell.

À l’invite de commandes PowerShell, tapez la commande suivante :

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

Dans un éditeur HTML, ouvrez le fichier dans lequel l’événement d’utilisation personnalisé doit être enregistré (par exemple, un modèle d’affichage pour un composant WebPart de recherche de contenu). L’exemple qui suit montre comment remplacer les valeurs SiteId, WebId et UserId actuelles.

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

Où :

<CustomUsageEventType> est le nom du type d’événement personnalisé (par exemple, BuyEventType).
<GUID> est l’ID numérique du type d’événement d’utilisation (par exemple, 4e605543-63cf-4b5f-aab6-99a10b8fb257).

Dans un éditeur HTML, ouvrez le fichier qui se rapporte au type d’événement d’utilisation personnalisé et ajoutez le code suivant :
```
# 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>
```
Où :
- <CustomUsageEventType> est le nom du type d’événement personnalisé (par exemple, BuyEventType).
- <URL> est l’URL détectée dans la propriété gérée OriginalPath.
- <SiteId GUID> est le GUID SiteId du site de création. Pour plus d’informations sur l’obtention du GUID SiteId, voir Get SiteId GUID and WebId GUID for a site.
- <WebId GUID> est le GUID WebId du site de création. Pour plus d’informations sur l’obtention du GUID WebId, voir Get SiteId GUID and WebId GUID for a site.
- <UserName> peut être un ID de cookie qui sert à identifier des utilisateurs sur un site qui accueille des utilisateurs anonymes.

Enregistrer un événement d’utilisation par défaut

Pour ajouter du code qui se rapporte à un type d’événement d’utilisation par défaut (par exemple, des affichages), vous devez ajouter du code à l’endroit même où l’événement se produit.

Si vous utilisez la publication intersites qui dévoile le contenu d’un catalogue sur un site de publication, vous devez enregistrer l’événement d’utilisation dans l’URL de l’élément indexé et remplacer certains paramètres du site. Par exemple, si vous disposez sur un site de création d’un catalogue que vous avez publié sur un site de publication, quand un utilisateur exploite un élément du catalogue sur le site de publication, cet événement d’utilisation doit être enregistré dans l’élément sur le site de création. De plus, le code que vous ajoutez dans le but d’enregistrer l’événement d’utilisation doit remplacer les propriétés SiteId et WebId du site de publication et accepter à la place les propriétés SiteId et WebId du site de création.

Pour ajouter du code pour enregistrer un événement de l’utilisation par défaut

Vérifiez que vous disposez des appartenances suivantes :
- Rôle serveur fixe securityadmin sur l’instance SQL Server
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- Groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell
- Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.
Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder des autorisations d’utilisation des cmdlets SharePoint Server.

Notes

Si vous ne disposez pas des autorisations, contactez votre administrateur d’installation ou votre administrateur SQL Server afin de les demander. Pour plus d’informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Management Shell.

À l’invite de commandes PowerShell, tapez la commande suivante :

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

Dans un éditeur HTML, ouvrez le fichier dans lequel l’événement d’utilisation personnalisé doit être enregistré, par exemple un modèle d’affichage pour un composant WebPart de recherche de contenu, et ajoutez le code suivant :

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

Où :

<DefaultUsageEventType> est le nom du type d’événement d’utilisation par défaut (par exemple, Affichages).
<EventTypeId> est l’ID numérique du type d’événement d’utilisation (par exemple, 1).

Dans un éditeur HTML, ouvrez le fichier qui se rapporte à l’événement d’utilisation par défaut et ajoutez le code suivant :
```
# The example below shows how a default usage event type is referred to on a page load:
<body onload="Log<DefaultUsageEventType>ToEventStore('<URL>')"> 
```
Où :
- <DefaultUsageEventType> est le nom du type d’événement d’utilisation par défaut (par exemple, Affichages).
- <URL> est l’URL complète de l’élément dans lequel l’événement d’utilisation est à enregistrer (par exemple, https://contoso.com/careers).
Enregistrez le fichier.

Pour ajouter du code pour enregistrer un événement de l’utilisation par défaut et de remplacer les paramètres de site

Vérifiez que vous disposez des appartenances suivantes :
- Rôle serveur fixe securityadmin sur l’instance SQL Server
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- Groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell
- Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.
Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder des autorisations d’utilisation des cmdlets SharePoint Server.

Notes

Si vous ne disposez pas des autorisations, contactez votre administrateur d’installation ou votre administrateur SQL Server afin de les demander. Pour plus d’informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Management Shell.

À l’invite de commandes PowerShell, tapez la commande suivante :

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

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

Où :

<DefaultUsageEventType> est le nom du type d’événement par défaut (par exemple, Affichages).
<EventTypeId> est l’ID numérique du type d’événement d’utilisation (par exemple, 1).

Dans un éditeur HTML, ouvrez le fichier qui se rapporte au type d’événement d’utilisation par défaut et ajoutez le code suivant :
```
# 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>')">
```
Où :
- <DefaultUsageEventType> est le nom du type d’événement par défaut (par exemple, Affichages).
- <URL> est l’URL dans la propriété gérée OriginalPath.
- <SiteId GUID> est le GUID SiteId du site de création. Pour plus d’informations sur l’obtention du GUID SiteId, voir Get SiteId GUID and WebId GUID for a site.
- <WebId GUID> est le GUID WebId du site de création. Pour plus d’informations sur l’obtention du GUID WebId, voir Get SiteId GUID and WebId GUID for a site.
- <UserName> peut, par exemple, être un ID de cookie qui sert à identifier des utilisateurs sur un site qui accueille des utilisateurs anonymes.

Notes

Changer le niveau d’importance d’un type d’événement d’utilisation

La propriété de type d’événement d’utilisation RecommendationWeight est une valeur numérique qui indique le niveau d’importance d’un type d’événement d’utilisation en comparaison à d’autres types d’événement d’utilisation employés dans le calcul des recommandations. Le type d’événement d’utilisation par défaut Affichages dispose d’une valeur RecommendationWeight préconfigurée et définie sur 1. Les autres types d’événement d’utilisation par défaut (Affichages en tant que recommendation, Clics en tant que recommandation et l’ensemble des types d’événement d’utilisation personnalisé) ont une valeur RecommendationWeight définie sur 0. Pour augmenter l’importance d’un type d’événement d’utilisation dans le calcul des recommandations, changez la valeur du paramètre RecommendationWeight. Le niveau d’importance disponible le plus élevé est 10.

Pour modifier le niveau d’importance d’un type d’événement de l’utilisation

Vérifiez que vous disposez des appartenances suivantes :
- Rôle serveur fixe securityadmin sur l’instance SQL Server
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- Groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell
- Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.
Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder des autorisations d’utilisation des cmdlets SharePoint Server.

Notes

Si vous ne disposez pas des autorisations, contactez votre administrateur d’installation ou votre administrateur SQL Server afin de les demander. Pour plus d’informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Management Shell.

À l’invite de commandes PowerShell, tapez la commande suivante :

# 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

Où :

<EventTypeId> est l’ID numérique du type d’événement d’utilisation dont vous souhaitez changer le poids (par exemple, 256).
<RecommendationWeightNumber> est le niveau d’importance que vous voulez appliquer au type d’événement d’utilisation (par exemple, 4).

Notes

Modifier le critère de temps Récent pour un type d’événement d’utilisation

La propriété de type d’événement d’utilisation RecentPopularityTimeframe est une valeur numérique qui définit le critère de temps Récent dans le rapport Éléments les plus populaires. Ce rapport dévoile les éléments les plus populaires par type d’événement d’utilisation pour tous les éléments d’une bibliothèque ou d’une liste. Le rapport peut être trié selon les critères de temps Récent ou Toujours. Par défaut, le critère de temps Récent est défini sur les 14 derniers jours de chaque événement d’utilisation. Vous pouvez changer ce paramètre avec une période allant de un à 14 jours.

Pour modifier la période de temps récente pour un type d’événement de l’utilisation

Vérifiez que vous disposez des appartenances suivantes :
- Rôle serveur fixe securityadmin sur l’instance SQL Server
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- Groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell
- Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.
Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder des autorisations d’utilisation des cmdlets SharePoint Server.

Notes

Si vous ne disposez pas des autorisations, contactez votre administrateur d’installation ou votre administrateur SQL Server afin de les demander. Pour plus d’informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Management Shell.

À l’invite de commandes PowerShell, tapez la commande suivante :

# 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

Où :

<EventTypeId> est l’ID numérique du type d’événement d’utilisation dont vous souhaitez changer le critère de temps Récent (par exemple, 256).
<TimeFrame> est le nouveau critère de temps Récent que vous cherchez à appliquer au type d’événement d’utilisation (par exemple, 7).

Notes

Le système met à jour toutes les modifications apportées au critère de temps Récent uniquement après exécution de la tâche du minuteur d’analyse d’utilisation.

Notes

Activer et désactiver la journalisation des événements d’utilisation des utilisateurs anonymes

Les utilisateurs qui explorent le contenu d’un site sans se connecter sont appelés « utilisateurs anonymes ». Seul le type d’événement Affichages est activé pour la journalisation des utilisateurs anonymes. Par défaut, la journalisation des événements d’utilisation personnalisés est désactivée dans le cas des utilisateurs anonymes.

Pour activer la journalisation des événements sur l’utilisation des utilisateurs anonymes

Vérifiez que vous disposez des appartenances suivantes :
- Rôle serveur fixe securityadmin sur l’instance SQL Server
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- Groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell
- Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.
Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder des autorisations d’utilisation des cmdlets SharePoint Server.

Notes

Si vous ne disposez pas des autorisations, contactez votre administrateur d’installation ou votre administrateur SQL Server afin de les demander. Pour plus d’informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Management Shell.

À l’invite de commandes PowerShell, tapez la commande suivante :

# 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

Où :

<EventTypeId> est l’ID numérique du type d’événement d’utilisation que vous souhaitez activer pour la journalisation des utilisateurs anonymes (par exemple, 256).

Pour désactiver l’enregistrement des événements sur l’utilisation des utilisateurs anonymes

Vérifiez que vous disposez des appartenances suivantes :
- Rôle serveur fixe securityadmin sur l’instance SQL Server
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- Groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell
- Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.
Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder des autorisations d’utilisation des cmdlets SharePoint Server.

Notes

Si vous ne disposez pas des autorisations, contactez votre administrateur d’installation ou votre administrateur SQL Server afin de les demander. Pour plus d’informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Management Shell.

À l’invite de commandes PowerShell, tapez la commande suivante :

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

Où :

<EventTypeId> est l’ID numérique du type d’événement d’utilisation que vous souhaitez désactiver pour la journalisation des utilisateurs anonymes (par exemple, 256).

Notes

Pour le type d’événement d’utilisation par défaut Affichages, la journalisation des utilisateurs anonymes est impossible.

Notes

Obtenir SiteId GUID et WebId GUID pour un site

Vous pouvez utiliser les commandes PowerShell suivantes pour obtenir le GUID SiteId et le GUID WebId pour un site.

Pour obtenir des SiteId GUID et WebId GUID pour un site

Vérifiez que vous disposez des appartenances suivantes :
- Rôle serveur fixe securityadmin sur l’instance SQL Server
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- Groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell
- Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.
Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder des autorisations d’utilisation des cmdlets SharePoint Server.

Notes

Si vous ne disposez pas des autorisations, contactez votre administrateur d’installation ou votre administrateur SQL Server afin de les demander. Pour plus d’informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Management Shell.
À l’invite de commandes PowerShell, tapez la commande suivante :
```
# 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
```
Où :
- <RootSiteURL> est l’URL du site racine dont vous souhaitez obtenir le GUID SiteId et le GUID WebId, par exemple https://contoso.com/sites/catalog.
- <SubSiteLocation> est le reste du chemin de l’URL vers le sous-site après l’URL du site racine. Par exemple, si l’URL de votre site racine est https://contoso.com/sites/catalog, et l’URL de votre sous-site https://contoso.com/sites/catalog/products, tapez products pour cet espace réservé.

Notes

Configurer des recommandations et des types d’événements de l’utilisation de SharePoint Server

Créer un type d’événement d’utilisation personnalisé

Enregistrer un événement d’utilisation personnalisé

Enregistrer un événement d’utilisation par défaut

Changer le niveau d’importance d’un type d’événement d’utilisation

Modifier le critère de temps Récent pour un type d’événement d’utilisation

Activer et désactiver la journalisation des événements d’utilisation des utilisateurs anonymes

Obtenir SiteId GUID et WebId GUID pour un site

See also

Ressources supplémentaires