Konfigurieren von Empfehlungen und verwendungsereignistypen in SharePoint Server

  • Artikel

GILT FÜR:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

Usage events enable you to track how users interact with items on your site. Items can be documents, sites, or catalog items. Wenn ein Benutzer mit einem Element auf Ihrer Website interagiert, generiert SharePoint Server ein Verwendungsereignis für diese Aktion. For example, if you want to monitor how often a catalog item is viewed from a mobile phone, you can track this activity.

In diesem Artikel erfahren Sie, wie Sie benutzerdefinierte Verwendungsereignistypen erstellen und Code für die Erfassung benutzerdefinierter Verwendungsereignisse hinzufügen, sodass diese von der Analyseverarbeitungskomponente verarbeitet werden können.

Die durch Verwendungsereignisse generierten Daten können zum Anzeigen von Empfehlungen oder beliebten Elementen auf Ihrer Website verwendet werden. In diesem Artikel erfahren Sie auch, wie Sie die Darstellung von Empfehlungen durch Ändern der Wichtigkeitsstufe für einen bestimmten Verwendungsereignistyp beeinflussen können. Weitere Informationen finden Sie unter "Planen von Nutzungsanalysen, Nutzungsereignissen und Empfehlungen" unter Planen der Suche für websiteübergreifende Veröffentlichungswebsites in SharePoint Server 2016.

Die Statistik für alle Verwendungsereignistypen kann in Berichten zu Beliebtheitstrends und beliebtesten Elementen angezeigt werden. Weitere Informationen finden Sie unter View usage reports in SharePoint Server.

Erstellen eines benutzerdefinierten Verwendungsereignistyps

Es gibt drei Standardnutzungsereignistypen in SharePoint Server. Sie können mit Microsoft PowerShell bis zu 12 benutzerdefinierte Nutzungsereignistypen erstellen.

So erstellen Sie einen benutzerdefinierten Verwendungsereignistyp

  1. Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:

  • Feste Serverrolle securityadmin auf der SQL Server-Instanz.

  • Feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden sollen.

  • Gruppe "Administratoren" auf dem Server, auf dem Sie die PowerShell-Cmdlets ausführen.

  • Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.

    Mit dem Cmdlet Add-SPShellAdmin kann ein Administrator die Berechtigung zur Verwendung von SharePoint Server-Cmdlets gewähren.

    Hinweis

    Wenn Sie nicht über Berechtigungen verfügen, wenden Sie sich an Ihren Setupadministrator oder SQL Server Administrator, um Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.

  1. Starten Sie die SharePoint-Verwaltungsshell.

  2. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung den folgenden Befehl ein:

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

Dabei gilt:

  • <SiteName> ist der Name der Website, für die Sie ein benutzerdefiniertes Verwendungsereignis erstellen möchten.

  • <EventTypeName> ist der Name des neuen benutzerdefinierten Verwendungsereignistyps, den Sie erstellen möchten, z. B. BuyEventType .

    Mit dieser Prozedur wird eine zufallsgenerierte GUID für den Verwendungsereignistyp erstellt. Verwenden Sie diese GUID, wenn Sie Code zum Erfassen des benutzerdefinierten Verwendungsereignisses hinzufügen (siehe Erfassen eines benutzerdefinierten Verwendungsereignisses).

    Wichtig

    Es kann bis zu drei Stunden dauern, bis ein benutzerdefinierter Verwendungsereignistyp im System verfügbar ist. Wenn Sie den Prozess beschleunigen möchten, führen Sie einen Neustart des SharePoint-Timerdiensts aus.

Hinweis

[!HINWEIS] Es wird empfohlen, Windows PowerShell zum Ausführen von administrativen Befehlszeilenaufgaben zu verwenden. Das Befehlszeilentool Stsadm ist veraltet, aber weiterhin vorhanden, um die Kompatibilität mit früheren Produktversionen zu gewährleisten.

Erfassen eines benutzerdefinierten Verwendungsereignisses

Nachdem Sie einen benutzerdefinierten Verwendungsereignistyp erstellt haben, wie unter Erstellen eines benutzerdefinierten Verwendungsereignistyps beschrieben, müssen Sie code an der Stelle hinzufügen, an der das Ereignis auftritt, z. B. wenn eine Seite geladen wird oder wenn ein Benutzer auf einen Link oder eine Schaltfläche klickt. Diese Daten werden dann an die Analyseverarbeitungskomponente gesendet, wo sie aufgezeichnet und verarbeitet werden.

Wenn Sie die websiteübergreifende Veröffentlichung verwenden, bei der Sie Kataloginhalte auf einer Veröffentlichungswebsite anzeigen, müssen Sie das Nutzungsereignis in der URL des indizierten Elements aufzeichnen und einige Websiteeinstellungen überschreiben. Wenn Sie also beispielsweise über einen Katalog auf einer Erstellungswebsite verfügen, diesen auf einer Veröffentlichungswebsite veröffentlicht haben und ein Benutzer mit dem Katalogobjekt auf der Veröffentlichungswebsite interagiert, muss dieses Verwendungsereignis für das Element auf der Erstellungswebsite erfasst werden. Außerdem müssen durch den Code, den Sie zum Erfassen des Verwendungsereignisses hinzufügen, die Website-ID und die Web-ID der Veröffentlichungswebsite durch die Website-ID und die Web-ID der Erstellungswebsite ersetzt werden.

So fügen Sie Code zum Aufzeichnen eines benutzerdefinierten Nutzungsereignisses hinzu

  1. Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:

  • Feste Serverrolle securityadmin auf der SQL Server-Instanz.

  • Feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden sollen.

  • Gruppe "Administratoren" auf dem Server, auf dem Sie die PowerShell-Cmdlets ausführen.

  • Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.

    Mit dem Cmdlet Add-SPShellAdmin kann ein Administrator die Berechtigung zur Verwendung von SharePoint Server-Cmdlets gewähren.

    Hinweis

    Wenn Sie nicht über Berechtigungen verfügen, wenden Sie sich an Ihren Setupadministrator oder SQL Server Administrator, um Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.

  1. Starten Sie die SharePoint-Verwaltungsshell.

  2. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# To view GUIDs for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft
  1. Öffnen Sie in einem HTML-Editor die Datei, in der das benutzerdefinierte Nutzungsereignis protokolliert werden soll, z. B. eine Anzeigevorlage für ein Inhaltssuche-Webpart, und fügen Sie den folgenden Code hinzu:
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 ist der Name des benutzerdefinierten Ereignisses, z. B. BuyEventType .

  • GUID ist die numerische ID des Verwendungsereignistyps, z. B. 4e605543-63cf-4b5f-aab6-99a10b8fb257.

  1. Öffnen Sie die Datei, in der auf das benutzerdefinierte Verwendungsereignis verwiesen wird, in einem HTML-Editor, und fügen Sie den folgenden Code hinzu:
# 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>

Dabei gilt Folgendes:

  • <CustomUsageEventType> ist der Name des benutzerdefinierten Ereignistyps.

  • <URL> ist die vollständige URL des Elements, in dem das Verwendungsereignis protokolliert werden soll, https://contoso.com/faqz. B. .

So fügen Sie Code hinzu, um ein benutzerdefiniertes Nutzungsereignis aufzuzeichnen und Websiteeinstellungen zu überschreiben

  1. Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:

  • Feste Serverrolle securityadmin auf der SQL Server-Instanz.

  • Feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden sollen.

  • Gruppe "Administratoren" auf dem Server, auf dem Sie die PowerShell-Cmdlets ausführen.

  • Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.

    Mit dem Cmdlet Add-SPShellAdmin kann ein Administrator die Berechtigung zur Verwendung von SharePoint Server-Cmdlets gewähren.

    Hinweis

    Wenn Sie nicht über Berechtigungen verfügen, wenden Sie sich an Ihren Setupadministrator oder SQL Server Administrator, um Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.

  1. Starten Sie die SharePoint-Verwaltungsshell.

  2. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# To view GUIDs for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft
  1. Öffnen Sie in einem HTML-Editor die Datei, in der das benutzerdefinierte Nutzungsereignis protokolliert werden soll, z. B. eine Anzeigevorlage für ein Inhaltssuche-Webpart. Im folgenden Beispiel wird gezeigt, wie Sie die aktuelle Website-ID, Web-ID und Benutzer-ID überschreiben:
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");
}

Dabei gilt Folgendes:

  • <CustomUsageEventType> ist der Name des benutzerdefinierten Ereignistyps, z. B. BuyEventType .

  • <GUID> ist die numerische ID des Verwendungsereignistyps, z. B. 4e605543-63cf-4b5f-aab6-99a10b8fb257 .

  1. Öffnen Sie die Datei, in der auf den benutzerdefinierten Verwendungsereignistyp verwiesen wird, in einem HTML-Editor, und fügen Sie den folgenden Code hinzu:
# 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>

Dabei gilt Folgendes:

  • <CustomUsageEventType> ist der Name des benutzerdefinierten Ereignistyps, z. B. BuyEventType.

  • <URL> ist die URL aus der verwalteten Eigenschaft "OriginalPath".

  • <Die SiteId-GUID> ist die SiteId-GUID der Erstellungswebsite. Informationen zum Abrufen der Website-ID-GUID finden Sie unter Abrufen der Website-ID-GUID und der Web-ID-GUID für eine Website.

  • <WebId GUID> ist die WebId-GUID der Erstellungswebsite. Informationen zum Abrufen der Web-ID-GUID finden Sie unter Abrufen der Website-ID-GUID und der Web-ID-GUID für eine Website.

  • <UserName> kann eine Cookie-ID sein, mit deren Hilfe Benutzer auf einer Website mit anonymen Benutzern identifiziert werden.

Erfassen eines standardmäßigen Verwendungsereignisses

Wenn Sie Code hinzufügen möchten, der sich auf einen Standardereignistyp für die Verwendung bezieht , z. B. Ansichten, müssen Sie code an der Stelle hinzufügen, an der das Ereignis auftritt.

Wenn Sie die websiteübergreifende Veröffentlichung verwenden, bei der Kataloginhalte auf einer Veröffentlichungswebsite angezeigt werden, müssen Sie das Nutzungsereignis in der URL des indizierten Elements aufzeichnen und einige Websiteeinstellungen überschreiben. Wenn Sie also beispielsweise über einen Katalog auf einer Erstellungswebsite verfügen, diesen auf einer Veröffentlichungswebsite veröffentlicht haben und ein Benutzer mit dem Katalogobjekt auf der Veröffentlichungswebsite interagiert, muss dieses Verwendungsereignis für das Element auf der Erstellungswebsite erfasst werden. Außerdem müssen durch den Code, den Sie zum Erfassen des Verwendungsereignisses hinzufügen, die Website-ID und die Web-ID der Veröffentlichungswebsite durch die Website-ID und die Web-ID der Erstellungswebsite ersetzt werden.

So fügen Sie Code zum Aufzeichnen eines Standardverwendungsereignisses hinzu

  1. Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:

  • Feste Serverrolle securityadmin auf der SQL Server-Instanz.

  • Feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden sollen.

  • Gruppe "Administratoren" auf dem Server, auf dem Sie die PowerShell-Cmdlets ausführen.

  • Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.

    Mit dem Cmdlet Add-SPShellAdmin kann ein Administrator die Berechtigung zur Verwendung von SharePoint Server-Cmdlets gewähren.

    Hinweis

    Wenn Sie nicht über Berechtigungen verfügen, wenden Sie sich an Ihren Setupadministrator oder SQL Server Administrator, um Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.

  1. Starten Sie die SharePoint-Verwaltungsshell.

  2. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft
  1. Öffnen Sie in einem HTML-Editor die Datei, in der das benutzerdefinierte Nutzungsereignis protokolliert werden soll, z. B. eine Anzeigevorlage für ein Inhaltssuche-Webpart, und fügen Sie den folgenden Code hinzu:
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");
}

Dabei gilt:

  • <DefaultUsageEventType> ist der Name des Standardverwendungsereignistyps, z. B. Views.

  • <EventTypeId> ist die numerische ID des Verwendungsereignistyps, z. B. 1.

  1. Öffnen Sie die Datei, in der auf das standardmäßige Verwendungsereignis verwiesen wird, in einem HTML-Editor, und fügen Sie den folgenden Code hinzu:
# The example below shows how a default usage event type is referred to on a page load:
<body onload="Log<DefaultUsageEventType>ToEventStore('<URL>')">

Dabei gilt Folgendes:

  • <DefaultUsageEventType> ist der Name des Standardverwendungsereignistyps, z. B. Views .

  • <URL> ist die vollständige URL des Elements, in dem das Verwendungsereignis protokolliert werden soll, https://contoso.com/careersz. B. .

  1. Speichern Sie die Datei.

So fügen Sie Code hinzu, um ein Standardnutzungsereignis aufzuzeichnen und Websiteeinstellungen zu überschreiben

  1. Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:

  • Feste Serverrolle securityadmin auf der SQL Server-Instanz.

  • Feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden sollen.

  • Gruppe "Administratoren" auf dem Server, auf dem Sie die PowerShell-Cmdlets ausführen.

  • Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.

    Mit dem Cmdlet Add-SPShellAdmin kann ein Administrator die Berechtigung zur Verwendung von SharePoint Server-Cmdlets gewähren.

    Hinweis

    Wenn Sie nicht über Berechtigungen verfügen, wenden Sie sich an Ihren Setupadministrator oder SQL Server Administrator, um Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.

  1. Starten Sie die SharePoint-Verwaltungsshell.

  2. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft
  1. Öffnen Sie in einem HTML-Editor die Datei, in der das benutzerdefinierte Nutzungsereignis protokolliert werden soll, z. B. eine Anzeigevorlage für ein Inhaltssuche-Webpart. Das folgende Beispiel zeigt, wie die aktuelle SiteId, die WebId und die UserId überschrieben werden.
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");
}

Dabei gilt:

  • <DefaultUsageEventType> ist der Name des Standardereignistyps, z. B. Views .

  • <EventTypeId> ist die numerische ID des Verwendungsereignistyps, z. B. 1 .

  1. Öffnen Sie die Datei, in der auf den standardmäßigen Verwendungsereignistyp verwiesen wird, in einem HTML-Editor, und fügen Sie den folgenden Code hinzu:
# 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>')">

Dabei gilt Folgendes:

  • <DefaultUsageEventType> ist der Name des Standardereignistyps, z. B. Views .

  • <URL> ist die URL in der verwalteten Eigenschaft OriginalPath.

  • <Die SiteId-GUID> ist die SiteId-GUID der Erstellungswebsite. Informationen zum Abrufen der Website-ID-GUID finden Sie unter Abrufen der Website-ID-GUID und der Web-ID-GUID für eine Website.

  • <WebId GUID> ist die WebId-GUID der Erstellungswebsite. Informationen zum Abrufen der Web-ID-GUID finden Sie unter Abrufen der Website-ID-GUID und der Web-ID-GUID für eine Website.

  • <UserName> kann beispielsweise eine Cookie-ID sein, mit deren Hilfe Benutzer auf einer Website mit anonymen Benutzern identifiziert werden.

Hinweis

[!HINWEIS] Es wird empfohlen, Windows PowerShell zum Ausführen von administrativen Befehlszeilenaufgaben zu verwenden. Das Befehlszeilentool Stsadm ist veraltet, aber weiterhin vorhanden, um die Kompatibilität mit früheren Produktversionen zu gewährleisten.

Ändern der Wichtigkeitsstufe eines Verwendungsereignistyps

Die Verwendungsereignistyp-Eigenschaft RecommendationWeight ist ein numerischer Wert, der die Wichtigkeit eines Verwendungsereignistyps relativ zu anderen Verwendungsereignistypen angibt, die im Rahmen der Empfehlungsberechnung verwendet werden. Für den standardmäßigen Verwendungsereignistyp Ansichten ist der Wert für RecommendationWeight auf "1" festgelegt. Bei den anderen standardmäßigen Verwendungsereignistypen ( Angezeigte Empfehlungen und Angeklickte Empfehlungen) sowie bei allen benutzerdefinierten Verwendungsereignistypen ist der Wert für RecommendationWeight auf "0" festgelegt. Wenn Sie die Wichtigkeit eines Verwendungsereignistyps in der Empfehlungsberechnung erhöhen möchten, ändern Sie den Wert des Parameters RecommendationWeight. Die höchstmögliche Wichtigkeitsstufe ist 10.

So ändern Sie die Wichtigkeitsebene eines Verwendungsereignistyps

  1. Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:

  • Feste Serverrolle securityadmin auf der SQL Server-Instanz.

  • Feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden sollen.

  • Gruppe "Administratoren" auf dem Server, auf dem Sie die PowerShell-Cmdlets ausführen.

  • Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.

    Mit dem Cmdlet Add-SPShellAdmin kann ein Administrator die Berechtigung zur Verwendung von SharePoint Server-Cmdlets gewähren.

    Hinweis

    Wenn Sie nicht über Berechtigungen verfügen, wenden Sie sich an Ihren Setupadministrator oder SQL Server Administrator, um Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.

  1. Starten Sie die SharePoint-Verwaltungsshell.

  2. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# 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

Dabei gilt:

  • <EventTypeId> ist die numerische ID des Verwendungsereignistyps, für den Sie die Gewichtung ändern möchten, z. B. 256.

  • <RecommendationWeightNumber> ist die Wichtigkeitsstufe, die Sie auf den Benutzerereignistyp anwenden möchten, z. B. 4.

Hinweis

[!HINWEIS] Es wird empfohlen, Windows PowerShell zum Ausführen von administrativen Befehlszeilenaufgaben zu verwenden. Das Befehlszeilentool Stsadm ist veraltet, aber weiterhin vorhanden, um die Kompatibilität mit früheren Produktversionen zu gewährleisten.

Ändern des Zeitraums vom Typ "Zuletzt verwendet" für einen Verwendungsereignistyp

Die Verwendungsereignistyp-Eigenschaft RecentPopularityTimeframe ist ein numerischer Wert zum Definieren des Zeitraums vom Typ Zuletzt verwendet im Bericht Beliebteste Elemente. Der Bericht "Beliebteste Elemente" zeigt die am häufigsten verwendeten Elemente pro Verwendungsereignistyp für alle Elemente in einer Bibliothek oder Liste an, z. B. die am häufigsten angezeigten Elemente in einer Bibliothek oder Liste. Der Bericht kann nach den Zeiträumen Zuletzt verwendet oder Jemals sortiert werden. Der Zeitraum für zuletzt verwendete Elemente ist für die einzelnen Verwendungsereignisse standardmäßig auf die letzten 14 Tage festgelegt. Sie können diesen Wert in einen Zeitraum zwischen einem und 14 Tagen ändern.

So ändern Sie den Zeitraum Zuletzt verwendet für einen Verwendungsereignistyp

  1. Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:

  • Feste Serverrolle securityadmin auf der SQL Server-Instanz.

  • Feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden sollen.

  • Gruppe "Administratoren" auf dem Server, auf dem Sie die PowerShell-Cmdlets ausführen.

  • Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.

    Mit dem Cmdlet Add-SPShellAdmin kann ein Administrator die Berechtigung zur Verwendung von SharePoint Server-Cmdlets gewähren.

    Hinweis

    Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.

  1. Starten Sie die SharePoint-Verwaltungsshell.

  2. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# 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

Dabei gilt:

  • <EventTypeId> ist die numerische ID des Verwendungsereignistyps, für den Sie den Zeitrahmen Zuletzt verwendet ändern möchten, z. B. 256.

  • <TimeFrame> ist der neue Zeitrahmen Zuletzt verwendet , den Sie auf den Benutzerereignistyp anwenden möchten, z. B. 7.

    Hinweis

    Die Änderungen am Zeitraum vom Typ "Zuletzt verwendet" werden erst nach Ausführung des Zeitgeberauftrags "Verwendungsanalyse" aktualisiert.

Hinweis

[!HINWEIS] Es wird empfohlen, Windows PowerShell zum Ausführen von administrativen Befehlszeilenaufgaben zu verwenden. Das Befehlszeilentool Stsadm ist veraltet, aber weiterhin vorhanden, um die Kompatibilität mit früheren Produktversionen zu gewährleisten.

Aktivieren und Deaktivieren der Protokollierung von Verwendungsereignissen anonymer Benutzer

Benutzer, die Inhalte auf einer Website betrachten, ohne mit einem Konto verbunden zu sein, werden als anonyme Benutzer bezeichnet. Für die Protokollierung anonymer Benutzer ist ausschließlich der Ereignistyp Ansichten aktiviert. Die Protokollierung benutzerdefinierter Verwendungsereignisse ist für anonyme Benutzer standardmäßig deaktiviert.

So aktivieren Sie die Protokollierung von Nutzungsereignissen anonymer Benutzer

  1. Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:

  • Feste Serverrolle securityadmin auf der SQL Server-Instanz.

  • Feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden sollen.

  • Gruppe "Administratoren" auf dem Server, auf dem Sie die PowerShell-Cmdlets ausführen.

  • Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.

    Mit dem Cmdlet Add-SPShellAdmin kann ein Administrator die Berechtigung zur Verwendung von SharePoint Server-Cmdlets gewähren.

    Hinweis

    Wenn Sie nicht über Berechtigungen verfügen, wenden Sie sich an Ihren Setupadministrator oder SQL Server Administrator, um Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.

  1. Starten Sie die SharePoint-Verwaltungsshell.

  2. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# 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

Dabei gilt:

  • <EventTypeId> ist die numerische ID des Verwendungsereignistyps, den Sie für die Protokollierung anonymer Benutzer aktivieren möchten, z. B. 256.

So deaktivieren Sie die Protokollierung von Nutzungsereignissen anonymer Benutzer

  1. Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:

  • Feste Serverrolle securityadmin auf der SQL Server-Instanz.

  • Feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden sollen.

  • Gruppe "Administratoren" auf dem Server, auf dem Sie die PowerShell-Cmdlets ausführen.

  • Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.

    Mit dem Cmdlet Add-SPShellAdmin kann ein Administrator die Berechtigung zur Verwendung von SharePoint Server-Cmdlets gewähren.

    Hinweis

    Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.

  1. Starten Sie die SharePoint-Verwaltungsshell.

  2. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung den folgenden Befehl ein:

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

Dabei gilt:

  • <EventTypeId> ist die numerische ID des Verwendungsereignistyps, den Sie für die Protokollierung anonymer Benutzer deaktivieren möchten, z. B. 256.

    Hinweis

    Für den Standardnutzungsereignistyp Ansichten können Sie die Protokollierung anonymer Benutzer nicht deaktivieren.

Hinweis

[!HINWEIS] Es wird empfohlen, Windows PowerShell zum Ausführen von administrativen Befehlszeilenaufgaben zu verwenden. Das Befehlszeilentool Stsadm ist veraltet, aber weiterhin vorhanden, um die Kompatibilität mit früheren Produktversionen zu gewährleisten.

Abrufen der Website-ID-GUID und der Web-ID-GUID für eine Website

Mit den folgenden PowerShell-Befehlen können Sie die Website-ID-GUID und die Web-ID-GUID für eine Website abrufen.

So rufen Sie siteId GUID und WebId GUID für eine Website ab

  1. Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:

  • Feste Serverrolle securityadmin auf der SQL Server-Instanz.

  • Feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden sollen.

  • Gruppe "Administratoren" auf dem Server, auf dem Sie die PowerShell-Cmdlets ausführen.

  • Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.

    Mit dem Cmdlet Add-SPShellAdmin kann ein Administrator die Berechtigung zur Verwendung von SharePoint Server-Cmdlets gewähren.

    Hinweis

    Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.

  1. Starten Sie die SharePoint-Verwaltungsshell.

  2. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# 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

Dabei gilt:

  • <RootSiteURL> ist die URL der Stammwebsite, die Sie die SiteId-GUID und die WebId-GUID von abrufen möchten, https://contoso.com/sites/catalogz. B. .

  • <SubSiteLocation> ist der restliche URL-Pfad der Unterwebsite nach der Stammwebsite-URL. Wenn ihre Stammwebsite-URL beispielsweise lautet https://contoso.com/sites/catalog und ihre Unterwebsite-URL lautet https://contoso.com/sites/catalog/products, geben Sie products für diesen Platzhalter ein.

Hinweis

[!HINWEIS] Es wird empfohlen, Windows PowerShell zum Ausführen von administrativen Befehlszeilenaufgaben zu verwenden. Das Befehlszeilentool Stsadm ist veraltet, aber weiterhin vorhanden, um die Kompatibilität mit früheren Produktversionen zu gewährleisten.

Siehe auch

Konzepte

View usage reports in SharePoint Server

Weitere Ressourcen

Anzeigen von Empfehlungen und beliebten Elementen auf einer SharePoint Server 2013-Website