Get-CalendarDiagnosticLog
Bien que cette applet de commande soit disponible dans Exchange local et dans le service cloud, elle fonctionne uniquement dans Exchange local. Dans le service cloud, utilisez plutôt l’applet de commande Get-CalendarDiagnosticObjects.
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 Syntaxe da la cmdlet Exchange.
Syntaxe
MeetingId
Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-MeetingID <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-LogLocation <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[<CommonParameters>]
MeetingSubject
Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-Subject <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-LogLocation <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[<CommonParameters>]
ExportToMsg
Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-LogLocation <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-EndDate <ExDateTime>]
[-EntryId <String>]
[-ExactMatch <Boolean>]
[-ItemClass <String[]>]
[-ItemIds <String[]>]
[-Latest]
[-MeetingID <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[-StartDate <ExDateTime>]
[-Subject <String>]
[<CommonParameters>]
Description
Le résultat de cette cmdlet contient les informations suivantes :
- IsFileLink : indique si l’élément de calendrier est exporté vers un fichier .msg à l’aide du paramètre LogLocation. Les valeurs sont True ou False.
- Identité : identifie la boîte aux lettres qui contient l’élément de calendrier. Exemple de valeur : excallog://laura@contoso.com/ ?id=RgAAAACF/h/dHTTkQbdPrk7z+G4SBwCoatc7EmnEQq1iF35p17stAAAAAAFEAACoatc7EmnEQq1iF35p17stAAAAABEIAAAP.
- LogDate : date-heure de journalisation de l’élément de calendrier.
- NormalizedSubject : champ Objet de l’élément de calendrier.
- CleanGlobalObjectId : identificateur constant tout au long de 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 cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Exemples
Exemple 1
Get-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "Weekly development meeting" -ExactMatch $true
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).
Exemple 2
Get-CalendarDiagnosticLog -Identity oevans -StartDate "6/1/2018 6:00:00 AM" -EndDate "6/30/2018 5:00:00 PM"
Cet exemple récupère les entrées du journal de diagnostic calendrier pour la boîte aux lettres d’Oscar Evans du 1/06/2018 au 30/06/2018.
Exemple 3
Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Weekly development meeting" -Latest
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) ».
Exemple 4
Get-CalendarDiagnosticLog -Identity "Jasen Kozma" -Subject "Budget Meeting" -ExactMatch $true -LogLocation "C:\My Documents\Calendar Diagnostic Export"
Dans Exchange 2013, cet exemple exporte tous les éléments de calendrier du journal de diagnostic du calendrier pour la boîte aux lettres de Jasen Kozma qui ont « Réunion budgétaire » n’importe où dans l’objet dans le dossier spécifié.
Remarques :
- Dans cet exemple, les fichiers de message sont écrits dans C :\Mes documents\Calendar Diagnostic Export\jkozma@contoso.com.
- Dans les organisations Exchange locales, vous pouvez utiliser l’applet de commande Get-CalendarDiagnosticAnalysis pour analyser les fichiers .msg exportés.
- Cet exemple ne fonctionne pas dans Exchange 2016 ou Exchange 2019, car le paramètre LogLocation n’est pas disponible.
Paramètres
-Credential
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Ce paramètre est disponible uniquement dans Exchange 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.
Une valeur pour ce paramètre nécessite l’applet de commande Get-Credential. Pour interrompre la commande et recevoir une invite à entrer les informations d’identification, utilisez la valeur (Get-Credential). Sinon, avant d’exécuter cette commande, stockez les informations d’identification dans une variable (par exemple, $cred = Get-Credential), puis utilisez le nom de cette variable name ($cred) pour ce paramètre. Pour plus d’informations, voir Get-Credential.
Propriétés des paramètres
| Type: | PSCredential |
| 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 |
-DomainController
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Ce paramètre est disponible uniquement dans Exchange 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 ».
Propriétés des paramètres
| Type: | Fqdn |
| 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 |
-EndDate
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le paramètre EndDate indique la fin de la plage de dates définies.
Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte MM/jj/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".
Propriétés des paramètres
| Type: | ExDateTime |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ExportToMsg
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-EntryId
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ExportToMsg
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExactMatch
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 et recherche tous les éléments de calendrier dans la boîte aux lettres. Par exemple, si vous recherchez « budget », la recherche recherche les éléments qui ont « budget » n’importe où dans l’objet, mais pas « budgétisation ».
- $false : la recherche d’objet utilise une correspondance partielle et recherche un maximum de 1 000 éléments de calendrier dans la boîte aux lettres. Par exemple, si vous recherchez « budget », la recherche recherche les éléments qui ont « budget » et « budgétisation » n’importe où dans le sujet. Cette valeur est la valeur par défaut.
Une recherche partielle de correspondance 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.
Vous utilisez ce paramètre uniquement avec le paramètre Subject.
La valeur de ce paramètre est ignorée lorsque vous utilisez le paramètre MeetingId.
Propriétés des paramètres
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ExportToMsg
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 la boîte aux lettres de manière unique. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Domaine\Nom d’utilisateur
- Adresse e-mail
- GUID
- LegacyExchangeDN
- SamAccountName
- Identifiant utilisateur ou nom d’utilisateur principal (UPN)
Attention : la valeur $null ou une valeur inexistante pour le paramètre Identity retourne tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.
Propriétés des paramètres
| Type: | MailboxIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ItemClass
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le paramètre ItemClass filtre les résultats en fonction de la valeur de propriété MessageClass spécifiée de l’élément de calendrier (par exemple, IPM.Appointment). Vous pouvez spécifier plusieurs valeurs séparées par des virgules.
Vous pouvez utiliser ce paramètre uniquement avec le paramètre MeetingID.
Propriétés des paramètres
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ExportToMsg
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ItemIds
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ExportToMsg
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Latest
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ExportToMsg
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-LogLocation
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Online
Remarque : Ce paramètre a été supprimé d’Exchange 2016 et Exchange 2019 par la Mises à jour cumulative H1 2022, car il accepte les valeurs de chemin UNC. L’utilisation de cette applet de commande est désormais limitée au serveur local.
Ce paramètre est fonctionnel uniquement dans Exchange 2010 et Exchange 2013.
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 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 Shannon Steele, les fichiers .msg sont en fait stockés dans C :\Mes documents\Calendar Export\ssteele@contoso.com.
Dans les organisations Exchange locales, vous pouvez utiliser l’applet de commande Get-CalendarDiagnosticAnalysis pour analyser les fichiers .msg exportés.
Remarque : les commandes qui utilisent ce paramètre peuvent échouer si l’élément de calendrier n’a pas de titre. Si vous recevez des erreurs lorsque vous utilisez ce paramètre, réexécutez la commande et remplacez ce paramètre par une redirection vers un fichier (| Set-Content -Path "C:\My Documents\Calendar Export") ou remplacez la sortie par une variable PowerShell.
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ExportToMsg
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
MeetingId
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
MeetingSubject
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MeetingID
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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é CleanGlobalObjectId de l’élément de calendrier disponible dans la sortie de cette applet de commande, ou à 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 trouver cette valeur, il est plus simple de rechercher d’abord l’élément de calendrier à l’aide des paramètres Subject, StartDate et EndDate. Une fois que vous avez trouvé l’élément de calendrier souhaité, vous pouvez utiliser sa valeur CleanGlobalObjectId pour le paramètre MeetingID dans les commandes ultérieures.
N’utilisez pas ce paramètre avec le paramètre Subject, car la valeur du paramètre MeetingID est prioritaire.
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
MeetingId
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
ExportToMsg
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ReadFromDomainController
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Ce paramètre est disponible uniquement dans Exchange 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. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
La commande : Set-AdServerSettings -ViewEntireForest $true pour inclure tous les objets dans la forêt, nécessite le commutateur ReadFromDomainController. Sinon, la commande peut utiliser un catalogue global qui contient des informations obsolètes. En outre, vous devrez peut-être exécuter plusieurs itérations de la commande avec le commutateur ReadFromDomainController pour obtenir les informations.
Par défaut, l’étendue du destinataire est définie sur le domaine qui héberge vos serveurs Exchange.
Propriétés des paramètres
| 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 |
-ResultSize
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Ce paramètre détermine le nombre de résultats retournés par l’applet de commande. La valeur maximale est 1000.
Propriétés des paramètres
| Type: | Unlimited |
| 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 |
-StartDate
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le paramètre StartDate indique le début de la plage de dates définies.
Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte MM/jj/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".
Propriétés des paramètres
| Type: | ExDateTime |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ExportToMsg
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Subject
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
MeetingSubject
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
ExportToMsg
| Position: | Named |
| Obligatoire: | True |
| 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
Input types
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.
Sorties
Output types
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.