CalCheck - Lo strumento di verifica dei calendari di Outlook

Articolo originale pubblicato giovedì 23 febbraio 2012

Nel corso dell'ultimo anno ho lavorato a questo strumento aggiungendo funzionalità e verifiche sulla base della mia esperienza come tecnico di Outlook e dei suggerimenti di altri tecnici. Beh, lo strumento è stato rilasciato questo febbraio in modo che tutti i nostri clienti possano scaricarlo e utilizzarlo per verificare i loro calendari e quindi risparmiare tempo in caso di problemi con il calendario personale di Outlook o con quello di un utente dell'organizzazione.

Installazione

Scaricare CalCheck dall'Area download Microsoft.

Questa utilità funziona con:

• Microsoft Office Outlook 2003
• Microsoft Office Outlook 2007
• Microsoft Office Outlook 2010 (32 bit)
• Microsoft Office Outlook 2010 (64 bit)
• Microsoft Exchange Server 2003
• Microsoft Exchange Server 2007
• Microsoft Exchange Server 2010

Importante: la versione a 64 bit di questo strumento deve essere utilizzata solo con la versione a 64 bit di Microsoft Outlook 2010.

Il download è costituito da un file ZIP. Decomprimerlo in una directory vuota, aprire una finestra di comando in tale directory ed eseguirlo.

Cosa fa CalCheck

Lo strumento di verifica dei calendari per Outlook (CalCheck) è un programma da riga di comando che ricerca gli eventuali problemi nei calendari di Microsoft Outlook. Lo strumento apre un profilo Outlook per accedere al Calendario di Outlook. Esegue diverse verifiche, ad esempio per le autorizzazioni, la pubblicazione delle informazioni sulla disponibilità, la configurazione dei delegati e la prenotazione automatica. Viene quindi verificato se i singoli elementi del calendario presentano problemi noti che possono causare comportamenti imprevisti, ad esempio riunioni che risultano mancanti.

Man mano che CalCheck esegue questo processo, genera un report che può essere utilizzato per diagnosticare gli elementi problematici o identificare le tendenze.

Verifiche eseguite

Vengono eseguite e registrate nel report le verifiche specifiche del Calendario seguenti:

• Autorizzazioni per il Calendario
• Delegati per il Calendario
• Dati relativi alla pubblicazione delle informazioni sulla disponibilità
• Impostazioni di prenotazione diretta per la cassetta postale o il Calendario
• Numero totale di elementi nella cartella del Calendario

Vengono eseguite e registrate nel report le verifiche a livello degli elementi seguenti:

• Nessun indirizzo di posta elettronica dell'organizzatore
• Nessun indirizzo di posta elettronica del mittente
• Nessuna proprietà dispidRecurring (che non fa mostrare un elemento nella visualizzazione per giorno/settimana/mese)
• Esistenza in termini temporali delle proprietà dispidApptStartWhole e dispidApptEndWhole
• Nessun oggetto per le riunioni che hanno luogo in futuro o per le riunioni ricorrenti (viene registrato un avviso)
• Verifica della classe di messaggi (viene registrato un avviso)
• Verifica di dispidApptRecur (blob di ricorrenza) per le ore di inizio e di fine complessive e non per le eccezioni
• Ricerca di elementi in conflitto nel Calendario
• Ricerca di elementi duplicati in base ad alcune proprietà MAPI
• Verifica dell'esistenza di oltre 1250 riunioni ricorrenti (viene registrato un avviso) e di 1300 riunioni ricorrenti (viene segnalato un errore); 1300 è il limite previsto
• Verifica del fatto di essere un partecipante e di essere diventato l'organizzatore di una riunione
• Verifica dei dati di eccezione delle riunioni per determinare che la dimensione sia corretta

Modalità server

È possibile eseguire CalCheck anche in modalità server. In tale modalità CalCheck tenta di aprire tutte le cassette postali presenti nel server Exchange e di eseguire le verifiche elencate nella sezione "Verifiche eseguite" di questo articolo. Viene generato un file CalCheckSvr.log in cui vengono riportate tutte le cassette postali con errori. CalCheck inoltre genera un file CalCheck__.log separato per ogni cassetta postale. In tale file di registro sono contenute informazioni più specifiche sulla cassetta postale.

Per utilizzare la modalità server, è necessario utilizzare un profilo di messaggistica associato a un account con autorizzazioni per tutte le cassette postali presenti nel server Exchange specificato. Per eseguire lo strumento in modalità server, utilizzare l'opzione della riga di comando "-S".

Esempio

Esecuzione per la verifica di una singola cassetta postale o di un singolo calendario:

Se non si specifica un profilo nella riga di comando, verrà richiesto di sceglierne uno, come mostrato nella cattura di schermata precedente.

Dopo la scelta del profilo, lo strumento verrà eseguito e verrà visualizzato un output simile al seguente se non ci sono errori:

In questa finestra viene indicato che esiste un file CalCheck.log e dove trovarlo. Aprendolo, verranno visualizzate informazioni simili alle seguenti:

02/17/2012 05:09:20PM Calendar Checking Tool - Version 1.0
02/17/2012 05:09:20PM ====================================
02/17/2012 05:13:45PM Opening mailbox: Mailbox 02/17/2012 05:13:45PM /O=Org/OU=OU/cn=Recipients/cn=Mailbox
02/17/2012 05:13:45PM Local time zone: Eastern Standard Time 02/17/2012 05:13:45PM Successfully opened the Calendar folder. 02/17/2012
05:13:45PM Processing calendar for Mailbox
02/17/2012 05:13:46PM Successfully located and opened the local free busy message for this mailbox.
02/17/2012 05:13:47PM Publishing 2 month(s) of free/busy data on the server.
02/17/2012 05:13:47PM Resource Scheduling / Automatically accept meeting requests is disabled.
02/17/2012 05:13:47PM ====================================
02/17/2012 05:13:47PM Delegates for this mailbox:
02/17/2012 05:13:47PM ===========================
02/17/2012 05:13:47PM No delegates are set.
02/17/2012 05:13:47PM ===========================
02/17/2012 05:13:47PM Permissions on this Calendar:
02/17/2012 05:13:47PM =============================
02/17/2012 05:13:47PM Default: None
02/17/2012 05:13:47PM Manager: Reviewer
02/17/2012 05:13:47PM Coworker1: None
02/17/2012 05:13:47PM Coworker2: Reviewer
02/17/2012 05:13:47PM Coworker3: Reviewer
02/17/2012 05:13:47PM =============================
02/17/2012 05:13:48PM Found 1404 items in the Calendar. Processing...
02/17/2012 05:13:48PM WARNING: No Subject on this item. You may want to add a Subject to this item.
02/17/2012 05:13:48PM Properties to help investigate this reported item: 02/17/2012 05:13:48PM Subject:
Location: No subject on recurring item
Start Time: 01/11/2011 10:00:00PM
End Time: 01/11/2011 10:30:00PM
Last Modifier: Mailbox
Last Modified Time: 02/04/2011 02:48:08PM
Is a recurring appointment: true
Sender Name: Mailbox
Sender Address: /o=Org/ou=OU/cn=recipients/cn=Mailbox
Organizer Name: Mailbox
Organizer Address: /o=Org/ou=OU/cn=recipients/cn=Mailbox
Recurrence Start: 12:00:00.000 AM 1/11/2011
Recurrence End: 12:00:00.000 AM 2/1/2011
Recurrence End Type: End After X Occurrences
Number of Exceptions: 0x0000
 
02/17/2012 05:13:50PM ERROR: Detected a duplicate item in the Calendar. Please check this item.
02/17/2012 05:13:50PM Properties to help investigate this reported item:
02/17/2012 05:13:50PM Subject: Doctor appointment
Location: Doctor’s Office
Start Time: 03/04/2012 04:30:00PM
End Time: 03/04/2012 06:00:00PM
Last Modifier: Mailbox
Last Modified Time: 08/01/2011 06:29:05PM
Is a recurring appointment: false
Sender Name: Mailbox
Sender Address: /o=Org/ou=OU/cn=recipients/cn=Mailbox
Organizer Name: Mailbox
Organizer Address: /o=Org/ou=OU/cn=recipients/cn=Mailbox

Per gli elementi che presentano problemi, nel report vengono fornite informazioni che è possibile utilizzare per individuarli e rimuoverli, ricrearli o, se possibile, correggerli e così via.

Opzioni di comando e relativa funzione

CalCheck [-P ] [-M ] [-S ] [-A] [-F] [-R] [-V] [-No] CalCheck -?
 
-P Nome profilo (se questo parametro non viene specificato, lo strumento richiederà di specificare un profilo)
-M DN cassetta postale (se questo parametro viene specificato, verrà elaborata solo la cassetta postale specificata)
-S Nome server (verrà elaborato l'intero server, tranne se viene specificata una cassetta postale)
-A Tutti gli elementi del calendario vengono inviati come output al file CALCHECK.CSV
-F Viene creata una cartella CalCheck e gli elementi con errori contrassegnati vengono spostati in tale cartella
-R Nella cartella Posta in arrivo viene inserito un messaggio di segnalazione contenente il file CalCheck.log
-V Alla finestra del prompt dei comandi viene inviato l'output dettagliato
-No Viene saltato un test degli elementi del calendario
Il parametro No con "org" consente di saltare il test relativo al partecipante che diventa organizzatore e con "dup" consente di saltare l'individuazione degli elementi duplicati
-? Viene stampato questo messaggio

Seguono ulteriori suggerimenti relativi a opzioni specifiche:

"-M" È necessario utilizzare legacyExchangeDN per la cassetta postale e il profilo utilizzato deve essere per una cassetta postale con l'autorizzazione per aprire l'altra cassetta postale.

"-A" Verrà creato un file CSV contenente tutti gli elementi del calendario, uno per ogni riga. Per ogni elemento saranno elencate diverse proprietà che possono essere utilizzate per ricercare i problemi non rilevati dallo strumento:

È possibile visualizzare tutti gli elementi presenti nel Calendario aprendo il file CSV in Excel. È possibile ordinare e filtrare gli elementi in base a informazioni quali l'ora di inizio, l'oggetto, gli elementi ricorrenti e così via. Ciò può essere utile per individuare problemi non rilevabili da CalCheck o attualmente non ricercati da CalCheck. Se si rileva un elemento che presenta un problema nel file CSV, è possibile aprire il Calendario e passare alla visualizzazione per categoria per ottenere una visualizzazione analoga del Calendario in Outlook.

A tale scopo, in Outlook fare clic sulla scheda Visualizza (View), fare clic su Cambia visualizzazione (Change View) e scegliere Per categoria (By Category). Si otterrà una visualizzazione del Calendario simile alla seguente:

In tale visualizzazione tutti gli elementi del Calendario vengono mostrati sotto forma di elenco, come se si stessero esaminando i messaggi di posta elettronica nella cartella Posta in arrivo. È possibile ordinare la visualizzazione in base a informazioni quali l'oggetto (Subject), la posizione (Location), l'ora di inizio (Start) e l'ora di fine (End). In questo modo è possibile trovare l'elemento problematico nella cartella del Calendario quando è difficile o impossibile individuarlo nella visualizzazione normale del Calendario.

"-F" Consentirà di creare nell'elenco delle cartelle una cartella CalCheck in cui verranno spostati tutti gli elementi contrassegnati come errori:

Gli elementi possono essere facilmente rispostati nel Calendario o essere eliminati da qui se non necessari oppure essere corretti (se possibile) e quindi reinseriti nel Calendario. La regola generale consisterebbe nel ricreare l'elemento eliminando quello spostato nella cartella CalCheck.

"-R" Consentirà di creare nella cartella Posta in arrivo un messaggio con allegato il file CalCheck.log. Ciò è utile se lo strumento viene eseguito in modalità server, in quanto ogni utente riceverà il rispettivo report nella propria cartella Posta in arrivo (Inbox):

"-No" Vi sono due opzioni di questo tipo, "-No org" e "-No dup":

Con "-No org" verrà saltata la verifica del partecipante divenuto organizzatore della riunione. Per parte di questa verifica viene utilizzato legacyExchangeDN della cassetta postale. Se legacyExchangeDN è cambiato per un motivo qualsiasi, ad esempio a seguito di una migrazione, il test genererà errori per elementi che in realtà possono non presentare problemi. L'errore registrato da CalCheck segnalerà entrambi i DN. Ecco un esempio:

12/21/2011 05:27:25PM ERROR: dispidApptStateFlags is 1, but the address for this mailbox does not match the organizer address.
12/21/2011 05:27:25PM Check to ensure the Organizer Address is correct, and whether or not this user should be the organizer.
12/21/2011 05:27:25PM Organizer Address: /o=Org1/ou=admin group 1/cn=recipients/cn=user1
12/21/2011 05:27:25PM DN for this user: /o=Org2/ou=admin group 2/cn=recipients/cn=user1
12/21/2011 05:27:25PM See KB 2563324 for additional information: https://support.microsoft.com/default.aspx?scid=kb;EN-US;2563324
12/21/2011 05:27:25PM Properties to help investigate this reported item: 12/21/2011 05:27:25PM Subject: Test

La cassetta postale in questo caso è effettivamente la stessa ma, poiché legacyExchangeDN è cambiato, viene contrassegnata come un errore.

Con "-No dup" verrà saltata l'individuazione degli elementi duplicati. Questo test crea un elenco in memoria degli elementi e verifica i singoli elementi in base a tale elenco. Ciò può rallentare leggermente il processo a causa delle attività di elaborazione e dell'utilizzo di memoria extra.

Cosa non fa CalCheck

• CalCheck è esclusivamente uno strumento di segnalazione degli errori. Non modifica o "corregge" automaticamente alcun elemento. Sposta gli elementi rilevati come errori nella cartella CalCheck se viene utilizzata l'opzione "-F", altrimenti non apporta alcuna modifica.
• CalCheck funziona solo con i calendari che si trovano in un server Exchange. Non funziona con altri server, ad esempio IMAP o POP3.
• CalCheck non è in grado di rilevare tutti i tipi di danneggiamento che un elemento del Calendario può presentare. Consente tuttavia di trovare molti problemi noti che possono essere risolti senza perdere troppo tempo ad analizzare un calendario e/o senza contattare un helpdesk.

Commenti e suggerimenti

Fateci avere i vostri commenti e suggerimenti! Il modo più semplice è su https://calcheck.codeplex.com/discussions

In caso di problemi con CalCheck, è possibile inserire un post su https://calcheck.codeplex.com/workitem/list/basic

Grazie. E spero che questo strumento vi aiuti a risparmiare tempo nel diagnosticare e risolvere autonomamente i problemi del calendario!

Randy Topken
Senior Escalation Engineer
Team di Outlook

Questo è un post di blog localizzato. L'articolo originale è disponibile in CalCheck - The Outlook Calendar Checking Tool.