Merge-SPLogFile

  • Référence
Module:
sharepoint-server
S’applique à:
SharePoint Server Subscription Edition

Regroupe les entrées du journal de suivi de tous les ordinateurs d'une batterie de serveurs dans un seul fichier journal sur l'ordinateur local.

Syntax

Merge-SPLogFile
     -Path <String>
     [-Area <String[]>]
     [-AssignmentCollection <SPAssignmentCollection>]
     [-Category <String[]>]
     [-ContextFilter <String[]>]
     [-Correlation <Guid[]>]
     [-EndTime <DateTime>]
     [-EventID <String[]>]
     [-ExcludeNestedCorrelation]
     [-Level <String>]
     [-Message <String[]>]
     [-Overwrite]
     [-Process <String[]>]
     [-StartTime <DateTime>]
     [-ThreadID <UInt32[]>]
     [<CommonParameters>]

Description

L'applet de commande Merge-SPLogFile renvoie les enregistrements à partir des fichiers journaux de suivi ULS (Unified Logging Service) de chaque serveur de la batterie correspondant aux critères et elle écrit les résultats dans un nouveau fichier journal sur l'ordinateur local. Si aucun résultat n’est retourné, un avertissement est écrit dans la fenêtre de console Windows PowerShell.

Nous vous recommandons de filtrer à l'aide des paramètres StartTime et EndTime pour optimiser les performances de cette cmdlet. Certains paramètres de filtrage tels que Process, Area, Category, EventID et Message prennent en charge les caractères génériques.

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

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite

Cet exemple fusionne la dernière heure des données du journal de tous les ordinateurs de la batterie de serveurs sans filtrage.

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

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Area Search

Cet exemple fusionne la dernière heure des données du journal de la zone Search.

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

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Area "SharePoint Foundation","Web Analytics Services"

Cet exemple fusionne la dernière heure des données du journal des zones SharePoint Foundation et Web Analytics Services.

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

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Level High

Cet exemple fusionne les données du journal de niveau High ou supérieur.

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

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -StartTime "06/09/2008 16:00" -EndTime "06/09/2008 16:15"

Cet exemple fusionne les données du journal pour les événements d’une plage de temps donnée, qui est spécifique à la culture des États-Unis.

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

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Message "*permission changed*"

Cet exemple fusionne les données du journal pour les événements comportant permission changed dans le texte du message.

--------------EXEMPLE 7-----------------

Merge-SPLogFile -Overwrite -Path d:\1.log -ContextFilter "name=timer job*" -Area "*search*"

Cet exemple fusionne les données du journal pour tous les travaux de recherche du minuteur.

--------------EXEMPLE 8-----------------

Merge-SPLogFile -Overwrite -Path d:\2.log -ContextFilter "user=contoso?joeuser"

Cet exemple montre comment fusionner les données du journal pour tous les noms d'utilisateurs qui présentent le format contoso\joeuser ou Contoso/joeuser.

Paramètres

-Area

Spécifie le nom de la zone à filtrer.

Le type doit correspondre à un nom valide, par exemple SharePoint Foundation.

L'utilisation de caractères génériques est prise en charge.

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

-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

-Category

Spécifie l'ID de catégorie sur lequel porte le filtrage.

Le type doit correspondre à un nom de catégorie valide, par exemple category1.

L'utilisation de caractères génériques est prise en charge.

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

-ContextFilter

Spécifie un filtre pour les entrées de suivi dans un contexte particulier au format clé=valeur, par exemple user=contoso\joeuser.

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

-Correlation

Spécifie l'ID de corrélation sur lequel porte le filtrage. Le type doit correspondre à un GUID valide au format F0BB0790-4323-A153-096F-ABCDC80E24D4.

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

-EndTime

Spécifie l'heure de fin des entrées du journal renvoyées.

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

-EventID

Spécifie l'ID d'événement sur lequel porte le filtrage. L'utilisation de caractères génériques est prise en charge.

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

-ExcludeNestedCorrelation

Exclut les valeurs de corrélation imbriquées dans les résultats. Ce paramètre n'est utilisé que pour le filtrage des résultats avec le paramètre ContextFilter.

Par défaut, les enregistrements renvoyés par le paramètre ContextFilter comprennent tous les enregistrements liés ainsi que tous les enregistrements qui correspondent au filtre. Lorsque vous spécifiez cette option, seuls les enregistrements qui correspondent au filtre sont inclus, les enregistrements liés étant exclus.

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

-Level

Spécifie le nom du niveau sur lequel porte le filtrage.

Les résultats comprennent le niveau spécifié et tout élément de gravité supérieure.

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

-Message

Spécifie le texte du message sur lequel porte le filtrage.

Le type doit être du texte valide. Le texte avec espaces doit être placé entre guillemets, par exemple "Ceci est un test".

L'utilisation de caractères génériques est prise en charge.

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

-Overwrite

Remplace le fichier journal s'il existe déjà sous le chemin d'accès spécifié.

Le type doit être l'une des valeurs suivantes :

  • $True
  • $False

La valeur par défaut est $false.

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

-Path

Spécifie le chemin d'accès et le nom de fichier pour l'écriture du fichier journal fusionné. Les chemins d'accès relatifs sont pris en charge.

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

-Process

Spécifie le nom du processus sur lequel porte le filtrage.

L'utilisation de caractères génériques est prise en charge.

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

-StartTime

Spécifie l'heure de début des entrées du journal renvoyées.

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.

La valeur par défaut est une heure avant l'heure actuelle sur l'ordinateur local.

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

-ThreadID

Spécifie l'ID du thread sur lequel porte le filtrage.

Le type doit être un entier valide compris entre 0 et 4 294 967 295.

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