Get-CalendarDiagnosticObjects

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Get-CalendarDiagnosticObjects per raccogliere un intervallo di log del calendario. I log di diagnostica del calendario tengono traccia dei dati importanti relativi agli eventi relativi al calendario per ogni cassetta postale e possono essere usati per risolvere i problemi relativi al calendario che si verificano nelle cassette postali. I log tengono traccia di tutti gli elementi del calendario e dei messaggi di riunione.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Get-CalendarDiagnosticObjects
   [-Identity] <UnifiedGroupOrUserMailboxIdParameter>
   [-AutoRequeryOnMeetingId <Boolean>]
   [-ConfigurationName <String>]
   [-CustomPropertyNames <String[]>]
   [-EndDate <ExDateTime>]
   [-EntryId <String>]
   [-EwsId <String>]
   [-ExactMatch <Boolean>]
   [-ItemClass <String[]>]
   [-ItemIds <String[]>]
   [-MaxResults <Int32>]
   [-MeetingId <String>]
   [-ODataId <String>]
   [-ResultSize <Unlimited>]
   [-ShouldBindToItem <Boolean>]
   [-ShouldDecodeEnums <Boolean>]
   [-ShouldFetchAttendeeCollection <Boolean>]
   [-ShouldFetchRecurrenceExceptions <Boolean>]
   [-StartDate <ExDateTime>]
   [-Subject <String>]
   [<CommonParameters>]

Descrizione

Alcune delle proprietà più interessanti restituite nei risultati sono:

  • AppointmentState: 1 = L'appuntamento è una riunione, 2 = L'appuntamento è stato ricevuto, 4 = L'appuntamento è stato annullato e 8 = l'appuntamento è un appuntamento inoltrato.
  • CalendarLogTriggerAction: azione eseguita sull'elemento, ad esempio Crea o Aggiorna.
  • ClientInfoString: entità che ha apportato la modifica, ad esempio , Client=OWA;<AdditionalDetails>Client=WebServices;<AdditionalDetails>;o Client=TBA;Service=MSExchangeMailboxAssistants;Action=ELCAssistant;.
  • MeetingRequestType: 1 = Il messaggio della riunione è una convocazione di riunione, 65536 = Il messaggio della riunione è un aggiornamento completo di una riunione esistente, 131072 = Il messaggio della riunione è un aggiornamento informativo a una riunione esistente, 262144 = Il messaggio della riunione è un aggiornamento invisibile all'utente, 524288 = L'aggiornamento è obsoleto o 1048576 = Il messaggio della riunione viene inoltrato a un delegato, e la copia è contrassegnata come informativa.
  • OriginalLastModifiedTime: usato come campo di ordinamento primario per ordinare gli eventi.
  • ResponseType: 0 = L'organizzatore non ha ricevuto una risposta, 1 = La copia dell'organizzatore della riunione, 2 = Tentative, 3 = Accept, 4 = Decline o 5 = Il partecipante non ha risposto.
  • ResponsibleUserName: valore LegacyExchangeDN dell'utente che ha apportato la modifica (ad esempio, /o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=BN6PR11MB1587/cn=Microsoft System Attendant o /o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=696eea97d3c449eab648920d03385efb-admin).

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Meeting" -ExactMatch $true

In questo esempio vengono recuperati i registri di diagnostica del calendario dalla cassetta postale di Pedro Pizarro per tutti gli elementi in cui l'oggetto è una corrispondenza esatta per una riunione del team.

Esempio 2

$A = Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Meeting" -ExactMatch $true

$A | Select-Object *,@{n='OLMT'; e={[DateTime]::Parse($_.OriginalLastModifiedTime.ToString())}} | sort OLMT | Format-Table OriginalLastModifiedTime,CalendarLogTriggerAction,ItemClass,ClientInfoString

Questo è lo stesso dell'esempio precedente, ma ora i risultati vengono ordinati in base all'ora dell'ultima modifica originale.

Esempio 3

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -MeetingID 40000008200E00074C5B7101A82E00800000000693ADAA3B5FCD201000000000000000010000000FF760A70460EAA4096B879872DF24F49

In questo esempio vengono recuperati i registri di diagnostica del calendario per la cassetta postale di Pedro Pizarro per una riunione con l'ID oggetto globale univoco specificato ID (GOID).

Esempio 4

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Lunch" -StartDate 7/1/2018 -EndDate 7/31/2018 | Export-Csv "C:\My Documents\Team Lunch Meeting.csv" -NoTypeInformation

Questo esempio restituisce informazioni di diagnostica per le riunioni con l'oggetto Team Lunch nella cassetta postale di Pedro Pizarro modificate nel mese di luglio 2018 ed esporta i risultati nel file C:\Documenti\Team Lunch Meeting.csv.

Parametri

-AutoRequeryOnMeetingId

{{ Fill AutoRequeryOnMeetingId Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ConfigurationName

{{ Fill ConfigurationName Description }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-CustomPropertyNames

Il parametro CustomPropertyNames consente di restituire la proprietà personalizzata dell'elemento del calendario specificato nei risultati. Per i valori validi, vedere Valori per il parametro CustomPropertyNames in Exchange Online PowerShell.

È possibile specificare più valori separati da virgole.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EndDate

Il parametro EndDate consente di specificare la data di fine dell'intervallo di date per la proprietà OriginalLastModifiedTime (quando la riunione è stata modificata per l'ultima volta, non è stata creata).

Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Ad esempio, se il computer è configurato per l'utilizzo del formato di data breve mm/dd/yyyy, immettere 01/09/2018 per specificare il 1° settembre 2018. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".

Type:ExDateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EntryId

Il parametro EntryID consente di filtrare i risultati in base al valore della proprietà EntryID specificato, che corrisponde alla proprietà MAPI PR_ENTRYID.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EwsId

{{ Fill EwsId Description }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ExactMatch

Il parametro ExactMatch consente di specificare se utilizzare una corrispondenza esatta o parziale per i valori di testo specificati dal parametro Subject. I valori validi sono:

  • $true: la ricerca dell'oggetto usa una corrispondenza esatta e cerca tutti gli elementi del calendario nella cassetta postale. Ad esempio, se si cerca "budget", la ricerca cerca gli elementi con "budget" in qualsiasi punto dell'oggetto, ma non "budget".
  • $false: la ricerca dell'oggetto usa una corrispondenza parziale e cerca un massimo di 1000 elementi del calendario nella cassetta postale. Ad esempio, se si cerca "budget", la ricerca cerca gli elementi con "budget" e "budgeting" in qualsiasi punto dell'oggetto. Questo è il valore predefinito.

Una ricerca per argomento parziale potrebbe non restituire tutti gli elementi del calendario pertinenti. Provare a utilizzare una ricerca con corrispondenza esatta per ottenere risultati più accurati.

Questo parametro viene usato solo con il parametro Subject.

Il valore di questo parametro viene ignorato quando si usa il parametro MeetingId.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

Il parametro Identity consente di specificare la cassetta postale o il gruppo di Microsoft 365 di cui si vuole visualizzare il calendario. È possibile usare qualsiasi valore che identifichi in modo univoco la cassetta postale o il gruppo di Microsoft 365. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Dominio\nomeutente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (UPN)
Type:UnifiedGroupOrUserMailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-ItemClass

Il parametro ItemClass consente di filtrare i risultati in base al valore della proprietà MessageClass specificato dell'elemento del calendario (ad esempio, IPM.Appointment). È possibile specificare più valori separati da virgole.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ItemIds

Il parametro ItemIds filtra i risultati in base all'ID elemento. È possibile specificare più valori separati da virgole.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-MaxResults

{{ Fill MaxResults Description }}

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-MeetingId

Il parametro MeetingId filtra i risultati in base all'identificatore univoco globale dell'elemento del calendario. Il valore è la proprietà CleanGlobalObjectId dell'elemento del calendario disponibile nell'output di questo cmdlet o usando altri strumenti di esame MAPI. Un valore di esempio è 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55. Questo valore è costante per tutta la durata dell'elemento del Calendario.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ODataId

{{ Fill ODataId Description }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

Questo parametro determina il numero di risultati restituiti dal cmdlet. Il valore massimo è 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShouldBindToItem

Il parametro ShouldBindToItem consente di specificare se troncare i valori della proprietà di cui può essere eseguito il flusso (ad esempio, AppointmentRecurrenceBlob). I valori validi sono:

  • $true: i valori delle proprietà streamable di grandi dimensioni non vengono troncati, quindi viene restituito il valore completo.
  • $false: i valori delle proprietà streamable di grandi dimensioni vengono troncati. Questo è il valore predefinito.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShouldDecodeEnums

{{ Fill ShouldDecodeEnums Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShouldFetchAttendeeCollection

{{ Fill ShouldFetchAttendeeCollection Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShouldFetchRecurrenceExceptions

Il parametro ShouldFetchRecurrenceExceptions consente di specificare se includere le eccezioni alle riunioni ricorrenti. I valori validi sono:

  • $true: includere eccezioni alle riunioni ricorrenti. Quando si utilizza questo valore, è necessario utilizzare anche il parametro ItemIds.
  • $false: non includere eccezioni alle riunioni ricorrenti. Questo è il valore predefinito.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-StartDate

Il parametro StartDate consente di specificare la data di inizio dell'intervallo di date per la proprietà OriginalLastModifiedTime (quando la riunione è stata modificata, non è stata creata).

Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Ad esempio, se il computer è configurato per l'utilizzo del formato di data breve mm/dd/yyyy, immettere 01/09/2018 per specificare il 1° settembre 2018. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".

Type:ExDateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Subject

Il parametro Subject consente di identificare gli elementi del Calendario in base al testo specificato nel campo Subject. Per i valori di testo specificati non viene fatta distinzione tra maiuscole e minuscole. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette. È possibile controllare se utilizzare una corrispondenza esatta mediante il parametro ExactMatch

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online