Get-CalendarDiagnosticAnalysis
Anche se questo cmdlet è disponibile in Exchange locale e nel servizio basato sul cloud, funziona solo in Exchange locale.
Utilizzare il cmdlet Get-CalendarDiagnosticAnalysis per risolvere i problemi di affidabilità correlati al calendario. È possibile utilizzare il cmdlet per analizzare i dati degli elementi del calendario registrati nei file di registro di diagnostica del calendario. Specificare i dati degli elementi calendario per questo cmdlet usando il cmdlet Get-CalendarDiagnosticLog.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-CalendarDiagnosticAnalysis
-CalendarLogs <CalendarLog[]>
[-DetailLevel <AnalysisDetailLevel>]
[-GlobalObjectId <String>]
[-OutputAs <OutputType>]
[<CommonParameters>]
Get-CalendarDiagnosticAnalysis
-LogLocation <String[]>
[-DetailLevel <AnalysisDetailLevel>]
[-GlobalObjectId <String>]
[-OutputAs <OutputType>]
[<CommonParameters>]
Descrizione
Le seguenti proprietà dell'elemento del calendario vengono restituite nei risultati predefiniti del cmdlet (quando il parametro DetailLevel è impostato su Basic):
- Ora log locale
- ItemId
- NormalizedSubject
- StartTime
- EndTime
- CalendarLogTriggerAction
- ClientInfoString
- OriginalLastModifiedTime
- ClientIntent
- CleanGlobalObjectId
- Itemclass
- ParentDisplay
- Durata
- AppointmentRecurring
- SentRepresentingEmailAddress
- SenderEmailAddress
- SentRepresentingDisplayName
È 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
$logs = Get-CalendarDiagnosticLog -Identity oevans -MeetingID 040000008200E00074C5B7101A82E008000000009421DCCD5046CD0100000000000000001000000010B0349F6B17454685E17D9F9512E71F
Get-CalendarDiagnosticAnalysis -CalendarLogs $logs -DetailLevel Advanced | Set-Content -Path "C:\My Documents\Oscar Evans Analysis.csv"
Questo esempio ottiene l'elemento del calendario specificato dalla cassetta postale di Oscar Evans, archivia l'elemento come variabile e scrive l'analisi avanzata dell'elemento in un file CSV.
Per l'analisi di base dell'elemento, non includere il parametro DetailLevel oppure il valore Basic anziché Advanced.
Esempio 2
Get-CalendarDiagnosticAnalysis -LogLocation "C:\My Documents\Exported Calendar Logs\jkozma@contoso.com" -DetailLevel Advanced -OutputAs HTML | Set-Content -Path "C:\My Documents\Jasen Kozma Analysis.html"
In Exchange 2013 questo esempio analizza gli elementi del calendario esportati in precedenza dalla cassetta postale di Jasen Kozma usando il cmdlet Get-CalendarDiagnosticLog con il parametro LogLocation e scrive l'analisi avanzata degli elementi in un file HTML.
Nota: il parametro LogLocation è disponibile solo in Exchange 2013. Per specificare la posizione degli elementi del calendario esportati in Exchange 2016 o Exchange 2019, vedere l'esempio 3.
Per l'analisi di base degli elementi, non includere il parametro DetailLevel oppure il valore Basic anziché Advanced.
Esempio 3
$calitems = Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Budget Meeting"
ForEach($item in $calitems){$i++; Get-CalendarDiagnosticAnalysis -CalendarLogs $item -OutputAs HTML | Set-Content -Path ("\\FileServer01\Data\Jasen Kozma Analysis{0}.html" -f $i)}
Questo esempio analizza gli elementi del calendario esportati dalla cassetta postale di Jasen Kozma usando il cmdlet Get-CalendarDiagnosticLog e scrive l'analisi avanzata per ogni elemento in un file HTML usando un percorso UNC.
Per l'analisi di base degli elementi, non includere il parametro DetailLevel oppure il valore Basic anziché Advanced.
Parametri
-CalendarLogs
Il parametro CalendarLogs consente di specificare l'elemento del calendario da analizzare. È possibile identificare l'elemento del calendario archiviando l'output del cmdlet Get-CalendarDiagnosticLog in una variabile e usando tale variabile per il valore di questo parametro.
Ad esempio, per analizzare la riunione con l'oggetto "November Budget Meeting" nella cassetta postale di Shannon Steele, eseguire il comando $Budget = Get-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "November Budget Meeting" -ExactMatch
e quindi usare il valore $Budget
per questo parametro.
Il valore usato per questo parametro deve identificare un singolo elemento. Per identificare più elementi, vedere l'esempio 3.
Non è possibile utilizzare questo parametro con il parametro LogLocation.
Type: | CalendarLog[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DetailLevel
Il parametro DetailLevel consente di specificare il livello di dettaglio che si desidera visualizzare nell'output dell'analisi. I valori validi sono:
- Basic: Questo è il valore predefinito. Le proprietà dell'elemento del calendario restituite sono elencate nella descrizione dettagliata.
- Advanced: vengono restituite 37 proprietà aggiuntive dell'elemento del calendario. Utilizzare questo valore solo per le informazioni di debug dettagliate.
Type: | AnalysisDetailLevel |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-GlobalObjectId
Il parametro GlobalObjectId consente di specificare l'identità globale dell'elemento di calendario da analizzare. In Exchange 2013 è possibile usare questo parametro con il parametro LogLocation per specificare l'elemento del calendario se il percorso contiene più file con estensione msg esportati.
La proprietà GlobalObjectId della riunione utilizza lo stesso formato della proprietà CleanGlobalObjectId ,ad esempio 0400000008200E00074C5B7101A82E008000000009421DCCD5046CD01000000000000000010000000010B0349F6B17454685E17D9F9512E71F) e il valore delle due proprietà è probabilmente lo stesso. Tuttavia, il valore di GlobalObjectId potrebbe non essere lo stesso per tutte le istanze della stessa riunione in più calendari (ad esempio, diversi partecipanti invitati a diverse istanze della stessa riunione ricorrente).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-LogLocation
Nota: questo parametro è stato rimosso da Exchange 2016 ed Exchange 2019 dal Aggiornamenti cumulativo 2022 H1 perché accetta i valori del percorso UNC. Per specificare gli elementi del calendario da analizzare, usare il parametro CalendarLogs.
Questo parametro funziona solo in Exchange 2013.
Il parametro LogLocation specifica il percorso in cui esportare gli elementi del calendario da analizzare. È possibile specificare un percorso locale o un percorso UNC (\\Server\Share\User
). Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
È possibile esportare gli elementi del calendario in file con estensione msg usando il cmdlet Get-CalendarDiagnosticLog con il parametro LogLocation. Se il percorso contiene più file .msg, tutti i file vengono analizzati quando si esegue Get-CalendarDiagnosticAnalysis.
Non è possibile utilizzare questo parametro con il parametro CalendarLogs.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Online |
-OutputAs
Il parametro OutputAs consente di specificare il formato output del comando. I valori validi sono:
- CSV (questo è il valore predefinito)
- HTML
- XML
Type: | OutputType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.