Merge-SPLogFile
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" -OverwriteCet 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 SearchCet 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 HighCet 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 |