Get-CalendarDiagnosticLog

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2017-03-27

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

Utilisez la cmdlet Get-CalendarDiagnosticLog pour collecter une plage de journaux de calendrier. Les journaux de diagnostic du calendrier effectuent le suivi de tous les éléments de calendrier et de toutes les demandes de réunion dans les boîtes aux lettres. Vous pouvez utiliser ces informations pour résoudre les problèmes de calendrier qui se produisent dans les boîtes aux lettres.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

Get-CalendarDiagnosticLog <COMMON PARAMETERS>

Get-CalendarDiagnosticLog -LogLocation <String> <COMMON PARAMETERS>

COMMON PARAMETERS: -Identity <UnifiedGroupOrUserMailboxIdParameter> [-Credential <PSCredential>] [-DomainController <Fqdn>] [-EndDate <ExDateTime>] [-EntryId <String>] [-ExactMatch <$true | $false>] [-ItemClass <String[]>] [-ItemIds <String[]>] [-Latest <SwitchParameter>] [-MeetingId <String>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-StartDate <ExDateTime>] [-Subject <String>]

Cet exemple présente l’extraction du journal de diagnostic du calendrier pour la boîte aux lettres de Jérôme Rivard en utilisant l’objet « Weekly development meeting » (Réunion de développement hebdomadaire).

Get-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "Weekly development meeting" -ExactMatch $true

Cet exemple montre l’extraction des entrées du journal de diagnostic du calendrier lié à la boîte aux lettres d’Oscar Evans du 01/06/2015 au 30/06/2015.

Get-CalendarDiagnosticLog -Identity oevans -StartDate "6/1/2015 6:00:00 AM" -EndDate "6/30/2015 5:00:00 PM"

Cet exemple montre l’extraction des données du journal de diagnostic du calendrier uniquement pour l’élément de calendrier le plus récent dans la boîte aux lettres de Gilbert Coupart, dont l’objet du message est le suivant : « Weekly development meeting » (Réunion de développement hebdomadaire) ».

Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Weekly development meeting" -Latest

Cet exemple illustre l’exportation (vers le dossier spécifié) de tous les éléments de calendrier dans le journal de diagnostic du calendrier lié à la boîte aux lettres de Gilbert Coupart dont l’objet comporte l’expression « Budget Meeting » (Réunion concernant le budget) à n’importe quel emplacement.

Get-CalendarDiagnosticLog -Identity "Jasen Kozma" -Subject "Budget Meeting" -ExactMatch $true -LogLocation "C:\My Documents\Calendar Diagnostic Export"

Remarques :

  • Dans cet exemple, les fichiers de messages sont écrits dans C:\My Documents\Calendar Diagnostic Export\jkozma@contoso.com.

  • Dans les organisations Exchange locales, vous pouvez utiliser la cmdlet Get-CalendarDiagnosticAnalysis avec le paramètre LogLocation pour analyser les fichiers .msg exportés.

Le résultat de cette cmdlet contient les informations suivantes :

  • IsFileLink   Il indique si l’élément du calendrier a été exporté vers un fichier .msg à l’aide du paramètre LogLocation. La valeur est True ou False.

  • Identity   Il identifie la boîte aux lettres qui contient l’élément de calendrier. Un exemple de valeur est excallog://laura@contoso.com/?id=RgAAAACF/h/dHTTkQbdPrk7z+G4SBwCoatc7EmnEQq1iF35p17stAAAAAAFEAACoatc7EmnEQq1iF35p17stAAAAABEIAAAP.

  • LogDate   Il indique la date-heure à laquelle l’élément de calendrier a été enregistré.

  • NormalizedSubject   Le champ Subject de l’élément de calendrier.

  • CleanGlobalObjectId   Cette valeur est constante pendant toute la durée de vie de l’élément de calendrier. Par exemple, 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55.

Lancez la cmdlet Get-CalendarDiagnosticLog pour analyser les données du calendrier récupérées à l’aide de la cmdlet Get-CalendarDiagnosticAnalysis. Pour plus d’informations, consultez la rubrique Get-CalendarDiagnosticAnalysis.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations nécessaires pour exécuter une cmdlet ou un paramètre dans votre organisation, consultez la rubrique Rechercher les autorisations requises pour exécuter les cmdlets Exchange.

 

Paramètre Obligatoire Type Description

Identity

Requis

Microsoft.Exchange.Configuration.Tasks.UnifiedGroupOrUserMailboxIdParameter

Le paramètre Identity indique la boîte aux lettres qui contient les éléments de calendrier. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la boîte aux lettres.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • <domain name>\<account name>

  • Adresse de messagerie

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)

LogLocation

Obligatoire

System.String

Le paramètre LogLocation spécifie l’emplacement vers lequel exporter les éléments de calendrier dans les fichiers .msg. Vous pouvez spécifier un chemin d’accès local ou un chemin d’accès UNC (\\<Server>\<Share>). Si la valeur contient des espaces, placez-la entre guillemets (").

À l’emplacement que vous spécifiez, un sous-dossier est automatiquement créé pour la boîte aux lettres spécifiée qui contient les éléments de calendrier exporté. Par exemple, si vous spécifiez la valeur C:\My Documents\Calendar Export pour exporter des éléments de calendrier à partir de la boîte aux lettres de Charline Leblanc, les fichiers .msg sont en réalité stockés dans C:\My Documents\Calendar Export\ssteele@contoso.com.

Dans les organisations Exchange locales, vous pouvez utiliser la cmdlet Get-CalendarDiagnosticAnalysis avec le paramètre LogLocation pour analyser les fichiers .msg exportés.

Credential

Facultatif

System.Management.Automation.PSCredential

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre Credential spécifie le nom d’utilisateur et le mot de passe utilisés pour exécuter cette commande. En règle générale, vous utilisez ce paramètre dans des scripts ou lorsque vous avez besoin de fournir différentes informations d’identification qui ont les autorisations requises.

Ce paramètre requiert la création et la transmission d’un objet d’informations d’identification. Cet objet d’informations d’identification est créé à l’aide de la cmdlet Get-Credential. Pour plus d’informations, voir Get-Credential.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : dc01.contoso.com.

EndDate

Facultatif

Microsoft.Exchange.ExchangeSystem.ExDateTime

Le paramètre EndDate indique la fin de la plage de dates définies.

Utilisez le format de date courte qui est défini dans les paramètres Options régionales de l’ordinateur sur lequel vous exécutez la commande. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte dd/mm/yyyy, entrez 01/09/2015 pour spécifier le 1er septembre 2015. Vous pouvez entrer la date uniquement, ou la date et l’heure de la journée. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets («  »), par exemple « 01/09/2015 17:00 ».

EntryId

Facultatif

System.String

Le paramètre EntryId filtre les résultats par ID d’entrée. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

ExactMatch

Facultatif

System.Boolean

Le paramètre ExactMatch spécifie si une correspondance exacte ou une correspondance partielle doit être utilisée pour les valeurs de texte spécifiées pour le paramètre Subject. Les valeurs valides sont les suivantes :

  • $true   La recherche d’objet utilise une correspondance exacte. Par exemple, si vous recherchez « budget », la commande renvoie tous les éléments de calendrier contenant « budget » dans l’objet, mais pas « budgeting ».

  • $false   La recherche d’objet utilise une correspondance partielle. Par exemple, si vous recherchez « budget », la commande renvoie tous les éléments de calendrier contenant « budget » et « budgeting » dans l’objet. Il s’agit de la valeur par défaut.

Une recherche de correspondance partielle d’objet peut ne pas renvoyer tous les éléments de calendrier pertinents. Essayez d’utiliser une recherche de correspondance exacte d’objet pour obtenir des résultats plus précis.

ItemClass

Facultatif

System.String[]

Le paramètre ItemClass permet de filtrer les résultats par classe d’élément. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Vous pouvez utiliser ce paramètre uniquement avec le paramètre MeetingID.

ItemIds

Facultatif

System.String[]

Le paramètre ItemIds filtre les résultats par ID d’élément. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Latest

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Latest indique si les données du journal de calendrier doivent être renvoyées uniquement pour l’élément de calendrier le plus récent. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

MeetingId

Facultatif

System.String

Le paramètre MeetingID filtre les résultats en fonction de l’identificateur global unique de l’élément de calendrier. La valeur est la propriété CleanGloablObjectId de l’élément de calendrier qui est disponible dans le résultat de la cmdlet, ou qui est obtenue à l’aide d’autres outils d’examen MAPI. Un exemple de valeur est 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55. Cette valeur est constante pendant toute la durée de vie de l’élément de calendrier.

Pour rechercher cette valeur, il est plus simple de rechercher d’abord l’élément de calendrier à l’aide des paramètres Subject, StartDate et EndDate. Après avoir trouvé l’élément de calendrier que vous souhaitez, vous pouvez utiliser sa valeur CleanGloablObjectId pour le paramètre MeetingID dans les futures commandes.

N’utilisez pas ce paramètre avec le paramètre Subject, car la valeur du paramètre MeetingID est prioritaire.

ReadFromDomainController

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le commutateur ReadFromDomainController spécifie quelles informations doivent être lues à partir d’un contrôleur de domaine dans le domaine de l’utilisateur. Si vous exécutez la commande Set-AdServerSettings -ViewEntireForest $true pour inclure tous les objets dans la forêt et que vous n'utilisez pas le commutateur ReadFromDomainController, vous n'obtiendrez peut-être pas des informations actualisées. Si vous utilisez le commutateur ReadFromDomainController, plusieurs lectures seront peut-être nécessaires avant d'obtenir l'information. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

noteRemarque :
Par défaut, la portée du destinataire est définie sur le domaine qui héberge vos serveurs Exchange.

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ResultSize spécifie le nombre maximal de résultats à renvoyer. Pour retourner toutes les demandes correspondant à la requête, utilisez unlimited comme valeur pour ce paramètre. La valeur par défaut est 1000.

StartDate

Facultatif

Microsoft.Exchange.ExchangeSystem.ExDateTime

Le paramètre StartDate indique le début de la plage de dates définies.

Utilisez le format de date courte qui est défini dans les paramètres Options régionales de l’ordinateur sur lequel vous exécutez la commande. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte dd/mm/yyyy, entrez 01/09/2015 pour spécifier le 1er septembre 2015. Vous pouvez entrer la date uniquement, ou la date et l’heure de la journée. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets («  »), par exemple « 01/09/2015 17:00 ».

Subject

Facultatif

System.String

Le paramètre Subject identifie les éléments de calendrier en fonction du texte spécifié dans le champ Subject. Les valeurs de texte que vous spécifiez ne respectent pas la casse. Si la valeur contient des espaces, placez-la entre guillemets ("). Vous pouvez décider d’utiliser ou non une correspondance exacte à l’aide du paramètre ExactMatch.

N’utilisez pas ce paramètre avec le paramètre MeetingID, car la valeur du paramètre MeetingID est prioritaire.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: