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.
Syntaxe
Default (Par défaut)
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
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AssignmentCollection
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | SPAssignmentCollection |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Category
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ContextFilter
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Spécifie un filtre pour les entrées de suivi dans un contexte particulier au format clé=valeur, par exemple user=contoso\joeuser.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Correlation
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | Guid[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-EndTime
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | DateTime |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-EventID
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Spécifie l'ID d'événement sur lequel porte le filtrage. L'utilisation de caractères génériques est prise en charge.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExcludeNestedCorrelation
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Level
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Message
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Overwrite
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Path
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Process
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Spécifie le nom du processus sur lequel porte le filtrage.
L'utilisation de caractères génériques est prise en charge.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-StartTime
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | DateTime |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ThreadID
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | UInt32[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.