Merge-SPUsageLog
Renvoie les enregistrements à partir de fichiers journaux d'utilisation.
Syntaxe
Default (Par défaut)
Merge-SPUsageLog
[-Identity] <SPUsageDefinitionPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-DiagnosticLogPath <String>]
[-EndTime <DateTime>]
[-OverWrite]
[-Partial]
[-Servers <String[]>]
[-StartTime <DateTime>]
[<CommonParameters>]
Description
L'applet de commande Merge-SPUsageLog renvoie les enregistrements des fichiers journaux d'utilisation de chaque serveur de la batterie de serveurs qui répondent aux critères et écrit les résultats sur le pipeline.
La commande regroupe, filtre et agrège des journaux en fonction des critères spécifiés par l'utilisateur. Nous vous recommandons de filtrer à l'aide des paramètres StartTime et EndTime pour optimiser les performances de l'applet de commande.
Vous devez spécifier au moins un type d'utilisation. Pour plus d'informations sur les types d'utilisation valides, consultez Get-SPUsageDefinition.
Cette applet de commande nécessite l’activation de la communication à distance PowerShell.
Exemples
Exemple 1
Merge-SPUsageLog -Identity 'Timer Jobs' -Servers SPSERVER1
Fusionne le journal d’utilisation de la définition d’utilisation « Travaux du minuteur » du serveur spécifié et les sorties dans la console PowerShell.
Paramètres
-AssignmentCollection
Applicable : 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 |
-DiagnosticLogPath
Applicable : SharePoint Server 2016, SharePoint Server 2019
Spécifie le fichier sur lequel écrire les informations de diagnostic. Un chemin d'accès relatif est 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: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-EndTime
Applicable : 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/heure valide propre à la culture de la langue d'administration. Par exemple 2/16/2007 12:15:12 pour Anglais-US.
La valeur par défaut est l'heure actuelle.
Si vous voulez spécifier l'heure UTC, vous devez ajouter un « Z » à la fin du paramètre. Par exemple, « 2016-06-15 03:29:18.199 Z ». Si vous ne spécifiez pas de « Z », l'heure de l'ordinateur local sera affichée à la place de l'heure UTC.
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 |
-Identity
Applicable : SharePoint Server 2016, SharePoint Server 2019
Spécifie le nom du fichier journal d’utilisation.
Propriétés du paramètre
| Type: | SPUsageDefinitionPipeBind |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-OverWrite
Applicable : SharePoint Server 2016, SharePoint Server 2019
Remplace le fichier journal de diagnostic s’il existe déjà sous le chemin d’accès spécifié.
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 |
-Partial
Applicable : SharePoint Server 2016, SharePoint Server 2019
Non utilisé.
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 |
-Servers
Applicable : SharePoint Server 2016, SharePoint Server 2019
L’adresse ou les adresses de serveur sur lesquelles filtrer.
Pour obtenir la liste d’adresses valides dans la batterie de serveurs, utilisez Get-SPServer | Sélectionner une adresse.
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 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/heure valide propre à 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.
Si vous voulez spécifier l'heure UTC, vous devez ajouter un « Z » à la fin du paramètre. Par exemple, « 2016-06-15 03:29:18.199 Z ». Si vous ne spécifiez pas de « Z », l'heure de l'ordinateur local sera affichée à la place de l'heure UTC.
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 |
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.
Entrées
Microsoft.SharePoint.PowerShell.SPUsageDefinitionPipeBind
Microsoft.SharePoint.PowerShell.SPAssignmentCollection