Get-CalendarDiagnosticLog
Anche se questo cmdlet è disponibile in Exchange locale e nel servizio basato sul cloud, funziona solo in Exchange locale. Nel servizio basato sul cloud usare invece il cmdlet Get-CalendarDiagnosticObjects.
Il cmdlet Get-CalendarDiagnosticLog consente di raccogliere una gamma di log del Calendario. I log di diagnostica del calendario tengono traccia di tutti gli elementi del calendario e delle convocazioni nelle cassette postali. È possibile utilizzare queste informazioni per la risoluzione dei problemi del calendario che si verificano nelle cassette postali.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-MeetingID <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-LogLocation <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-Subject <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-LogLocation <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[<CommonParameters>] 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>] Descrizione
L'output di questo cmdlet contiene le informazioni seguenti:
- IsFileLink: indica se l'elemento del calendario è stato esportato in un file con estensione msg usando il parametro LogLocation. I valori consentiti sono True o False.
- Identità: identifica la cassetta postale che contiene l'elemento del calendario. Un valore di esempio è: excallog://laura@contoso.com/?id=RgAAAACF/h/dHTTkQbdPrk7z+G4SBwCoatc7EmnEQq1iF35p17stAAAAAAFEACoatc7EmnEQq1iF35p17stAAAABEIAAAP.
- LogDate: data e ora di registrazione dell'elemento del calendario.
- NormalizedSubject: campo Oggetto dell'elemento del calendario.
- CleanGlobalObjectId: identificatore costante per tutta la durata dell'elemento del calendario. Ad esempio, 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55.
Dopo aver eseguito il cmdlet Get-CalendarDiagnosticLog, è possibile analizzare i dati di calendario utilizzando il cmdlet Get-CalendarDiagnosticAnalysis. Per ulteriori informazioni, vedere Get-CalendarDiagnosticAnalysis.
È 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-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "Weekly development meeting" -ExactMatch $trueIn questo esempio viene recuperato il log di diagnostica del calendario per la cassetta postale di Shannon Steele, utilizzando l'oggetto "Weekly development meeting".
Esempio 2
Get-CalendarDiagnosticLog -Identity oevans -StartDate "6/1/2018 6:00:00 AM" -EndDate "6/30/2018 5:00:00 PM"In questo esempio vengono recuperate le voci del log di diagnostica del calendario per la cassetta postale di Oscar Evans dal 1/06/2018 al 30/6/2018.
Esempio 3
Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Weekly development meeting" -LatestIn questo esempio vengono recuperati solo i dati del log di diagnostica del calendario relativi all'elemento del Calendario più recente nella cassetta postale di Jasen Kozma con oggetto del messaggio "Weekly development meeting".
Esempio 4
Get-CalendarDiagnosticLog -Identity "Jasen Kozma" -Subject "Budget Meeting" -ExactMatch $true -LogLocation "C:\My Documents\Calendar Diagnostic Export"In Exchange 2013 questo esempio esporta tutti gli elementi del calendario nel log di diagnostica del calendario per la cassetta postale di Jasen Kozma con "Riunione di budget" in qualsiasi punto dell'oggetto della cartella specificata.
Note:
- In questo esempio i file dei messaggi vengono scritti in C:\Documenti\Esportazione diagnostica calendario\jkozma@contoso.com.
- Nelle organizzazioni di Exchange locali è possibile usare il cmdlet Get-CalendarDiagnosticAnalysis per analizzare i file con estensione msg esportati.
- Questo esempio non funziona in Exchange 2016 o Exchange 2019 perché il parametro LogLocation non è disponibile.
Parametri
-Credential
Questo parametro è disponibile solo in Exchange locale.
Il parametro Credential consente di specificare il nome utente e la password usati per eseguire questo comando. In genere questo parametro viene utilizzato negli script o quando occorre fornire credenziali diverse con le autorizzazioni necessarie.
Un valore per questo parametro richiede il cmdlet Get-Credential. Per sospendere questo comando e visualizzare la richiesta di immissione delle credenziali, usare il valore (Get-Credential). In alternativa, prima di eseguire questo comando, archiviare le credenziali in una variabile (ad esempio, $cred = Get-Credential) e quindi usare il nome della variabile ($cred) per questo parametro. Per altre informazioni, vedere Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Questo parametro è disponibile solo in Exchange locale.
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-EndDate
Il parametro EndDate consente di specificare la data di fine dell'intervallo di date.
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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-EntryId
Il parametro EntryId filtra i risultati in base all'ID voce. È 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 Server 2016, Exchange Server 2019, 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 Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Il parametro Identity consente di specificare la cassetta postale che contiene gli elementi del Calendario. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. 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: | MailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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.
È possibile utilizzare questo parametro soltanto con il parametro MeetingID.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, 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 Server 2016, Exchange Server 2019, Exchange Online |
-Latest
L'opzione Latest consente di specificare se restituire i dati del log del Calendario solo per l'elemento del Calendario più recente. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| 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. L'utilizzo di questo cmdlet è ora limitato al server locale.
Questo parametro funziona solo in Exchange 2010 ed Exchange 2013.
Il parametro LogLocation specifica il percorso in cui esportare gli elementi del Calendario in file .msg. È possibile specificare un percorso locale o un percorso UNC (\\Server\Share). Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Nel percorso specificato, viene automaticamente creata una sottocartella per la cassetta postale specificata che contiene gli elementi del Calendario esportati. Ad esempio, se si specifica il valore "C:\Documenti\Esportazione calendario" per esportare gli elementi del calendario dalla cassetta postale di Shannon Steele, i file con estensione msg vengono effettivamente archiviati in C:\Documenti\Esportazione calendario\ssteele@contoso.com.
Nelle organizzazioni di Exchange locali è possibile usare il cmdlet Get-CalendarDiagnosticAnalysis per analizzare i file con estensione msg esportati.
Nota: i comandi che usano questo parametro potrebbero non riuscire se l'elemento del calendario non ha un titolo. Se si ricevono errori quando si usa questo parametro, eseguire di nuovo il comando e sostituire questo parametro con il reindirizzamento a un file (| Set-Content -Path "C:\My Documents\Calendar Export") o sostituire l'output con una variabile di PowerShell.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Online |
-MeetingID
Il parametro MeetingID consente di filtrare 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.
Per trovare questo valore, è più semplice cercare prima l'elemento del calendario usando i parametri Subject, StartDate e EndDate. Dopo aver trovato l'elemento del calendario desiderato, è possibile usare il relativo valore CleanGlobalObjectId per il parametro MeetingID nei comandi futuri.
Non utilizzare questo parametro con il parametro Subject, poiché il valore del parametro MeetingID ha la precedenza.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ReadFromDomainController
Questo parametro è disponibile solo in Exchange locale.
L'opzione ReadFromDomainController consente di specificare che le informazioni devono essere lette da un controller di dominio nel dominio dell'utente. Con questa opzione non è necessario specificare alcun valore.
Il comando: Set-AdServerSettings -ViewEntireForest $true per includere tutti gli oggetti nella foresta richiede l'opzione ReadFromDomainController. In caso contrario, il comando potrebbe usare un catalogo globale che contiene informazioni obsolete. Inoltre, potrebbe essere necessario eseguire più iterazioni del comando con l'opzione ReadFromDomainController per ottenere le informazioni.
Per impostazione predefinita, l'ambito del destinatario è impostato sul dominio che ospita i server di Exchange.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-StartDate
Il parametro StartDate consente di specificare la data di inizio dell'intervallo di date.
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 Server 2013, Exchange Server 2016, Exchange Server 2019, 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.
Non utilizzare questo parametro con il parametro MeetingID, poiché il valore del parametro MeetingID ha la precedenza.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, 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.