Get-SPLogEvent

Référence

Module:: sharepoint-server

S’applique à:: SharePoint Server Subscription Edition

Renvoie les résultats d'un journal de suivi ULS (Service de journalisation unifiée).

Syntax

Get-SPLogEvent
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AsString]
   [-ContextKey <String[]>]
   [-Directory <String>]
   [-MinimumLevel <String>]
   [-EndTime <DateTime>]
   [-StartTime <DateTime>]
   [<CommonParameters>]

Get-SPLogEvent
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AsString]
   [-ContextKey <String[]>]
   [-MinimumLevel <String>]
   [-EndTime <DateTime>]
   [-File <String>]
   [-StartTime <DateTime>]
   [<CommonParameters>]

Description

Cette cmdlet contient plus d’un jeu de paramètres. Vous ne pouvez utiliser les paramètres que d’un seul jeu et vous ne pouvez pas combiner les paramètres de différents jeux. Pour plus d’informations sur l’utilisation des jeux de paramètres, consultez les Jeux de paramètres des applets de commande.

L’applet de commande Get-SPLogEvent renvoie les enregistrements d’un fichier journal de suivi ULS correspondants aux critères. Si aucun paramètre n'est spécifié, tous les enregistrements de tous les fichiers journaux sont renvoyés. Utilisez les paramètres StartTime et EndTime pour appliquer un filtre sur un intervalle de temps. Nous recommandons l’utilisation de ces paramètres pour optimiser les performances de cette applet de commande.

Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

--------------EXEMPLE 1-----------------

Get-SPLogEvent -MinimumLevel "Warning"

Cet exemple renvoie toutes les entrées de journal provenant du répertoire de journaux par défaut correspondant à un avertissement ou à un état plus sévère.

--------------EXEMPLE 2-----------------

Get-SPLogEvent -Directory "C:\Logs" | Where-Object {$_.Level -eq "Warning"}

Cet exemple renvoie toutes les entrées d’avertissement des fichiers journaux du répertoire C:\Logs.

--------------EXEMPLE 3-----------------

Get-SPLogEvent -StartTime "12/04/2007 17:00" -EndTime "12/04/2007 18:00"

Cet exemple renvoie les entrées d’erreur survenues au cours d’un intervalle de temps, et il est propre aux États-Unis.

--------------EXEMPLE 4-----------------

Get-SPLogEvent -ContextKey @("UserName" ,"SiteName")

Cet exemple renvoie le contenu du dernier fichier journal et ajoute les données clés de contexte spécifiées.

--------------EXEMPLE 5-----------------

Get-SPLogEvent | Where-Object {$_.Level -eq "Error" -and {$_.Area -eq "SharePoint Foundation "}

Cet exemple renvoie toutes les entrées d’erreur relatives à SharePoint Foundation.

--------------EXEMPLE 6-----------------

Get-SPLogEvent -ContextKey @("Name") | %{$_.ToString() + "'t" + $_.Context["Name"]}

Cet exemple renvoie le contenu du fichier journal et ajoute des données de contexte.

Paramètres

-AssignmentCollection

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-AsString

Renvoie chaque enregistrement sous la forme d'une chaîne distincte.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ContextKey

Spécifie que les données de contexte doivent être ajoutées aux résultats des clés de contexte spécifiées, par exemple : -ContextKey @("UserName", "SiteName").

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Directory

Donne la liste des fichiers journaux d'un autre répertoire (tout répertoire autre que le répertoire LogLocation configuré).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-EndTime

Le type doit être un format date et heure valide dépendant de la culture de la langue d'administration. Par exemple 2/16/2007 12:15:12 pour Anglais-US.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-File

Spécifie un fichier spécifique à partir duquel demander des enregistrements.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-MinimumLevel

Renvoie les enregistrements équivalents ou supérieurs au niveau spécifié. Les valeurs valides sont Error ou Warning.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-StartTime