Get-CalendarDiagnosticAnalysis

Módulo:

ExchangePowerShell

Se aplica a:

Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Aunque este cmdlet está disponible en Exchange local y en el servicio basado en la nube, solo funciona en Exchange local.

Use el cmdlet Get-CalendarDiagnosticAnalysis para solucionar problemas de confiabilidad relacionados con el calendario. Puede usar este cmdlet para analizar los datos de elementos de calendario que se registran en los registros de diagnóstico de calendario. Los datos del elemento de calendario se proporcionan a este cmdlet mediante el cmdlet Get-CalendarDiagnosticLog.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Get-CalendarDiagnosticAnalysis
   -CalendarLogs <CalendarLog[]>
   [-DetailLevel <AnalysisDetailLevel>]
   [-GlobalObjectId <String>]
   [-OutputAs <OutputType>]
   [<CommonParameters>]

Get-CalendarDiagnosticAnalysis
   -LogLocation <String[]>
   [-DetailLevel <AnalysisDetailLevel>]
   [-GlobalObjectId <String>]
   [-OutputAs <OutputType>]
   [<CommonParameters>]

Description

Las siguientes propiedades del elemento de calendario se devuelven en la salida predeterminada del cmdlet (cuando el parámetro DetailLevel se establece en Básico):

• Hora de registro local
• ItemId
• NormalizedSubject
• StartTime
• EndTime
• CalendarLogTriggerAction
• ClientInfoString
• OriginalLastModifiedTime
• ClientIntent
• CleanGlobalObjectId
• ItemClass
• ParentDisplay
• Duración
• AppointmentRecurring
• SentRepresentingEmailAddress
• SenderEmailAddress
• SentRepresentingDisplayName

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

$logs = Get-CalendarDiagnosticLog -Identity oevans -MeetingID 040000008200E00074C5B7101A82E008000000009421DCCD5046CD0100000000000000001000000010B0349F6B17454685E17D9F9512E71F

Get-CalendarDiagnosticAnalysis -CalendarLogs $logs -DetailLevel Advanced | Set-Content -Path "C:\My Documents\Oscar Evans Analysis.csv"

En este ejemplo se obtiene el elemento de calendario especificado del buzón de Oscar Evans, se almacena el elemento como una variable y se escribe el análisis avanzado del elemento en un archivo CSV.

Para el análisis básico del elemento, no incluya el parámetro DetailLevel ni use el valor Basic en lugar de Advanced.

Ejemplo 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"

En Exchange 2013, este ejemplo analiza los elementos de calendario que se exportaron anteriormente desde el buzón de Jasen Kozma mediante el cmdlet Get-CalendarDiagnosticLog con el parámetro LogLocation y escribe el análisis avanzado de los elementos en un archivo HTML.

Nota: El parámetro LogLocation solo está disponible en Exchange 2013. Para especificar la ubicación de los elementos de calendario exportados en Exchange 2016 o Exchange 2019, consulte el ejemplo 3.

Para el análisis básico de los elementos, no incluya el parámetro DetailLevel ni use el valor Basic en lugar de Advanced.

Ejemplo 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)}

En este ejemplo se analizan los elementos de calendario que se exportaron desde el buzón de Jasen Kozma mediante el cmdlet Get-CalendarDiagnosticLog y se escribe el análisis avanzado de cada elemento en un archivo HTML mediante una ruta de acceso UNC.

Para el análisis básico de los elementos, no incluya el parámetro DetailLevel ni use el valor Basic en lugar de Advanced.

Parámetros

-CalendarLogs

El parámetro CalendarLogs especifica el elemento de calendario que desea analizar. Para identificar el elemento de calendario, almacene la salida del cmdlet Get-CalendarDiagnosticLog en una variable y use esa variable para el valor de este parámetro.

Por ejemplo, para analizar la reunión con el asunto "Reunión presupuestaria de noviembre" en el buzón de Shannon Steele, ejecute el comando $Budget = Get-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "November Budget Meeting" -ExactMatch y, a continuación, use el valor $Budget para este parámetro.

El valor que se usa para este parámetro debe identificar un solo elemento. Para identificar varios elementos, consulte el ejemplo 3.

No se puede usar este parámetro con el parámetro 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

El parámetro DetailLevel especifica el nivel de detalle que desea ver en la salida del análisis. Los valores admitidos son:

• Básico: este es el valor predeterminado. Las propiedades del elemento de calendario que se devuelven aparecen en la descripción detallada.
• Avanzadas: se devuelven 37 propiedades de elemento de calendario adicionales. Debe usar este valor solo para obtener información detallada sobre la depuración.

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

El parámetro GlobalObjectId especifica la identidad del elemento de calendario que desea analizar. En Exchange 2013, puede usar este parámetro con el parámetro LogLocation para especificar el elemento de calendario si la ubicación contiene varios archivos .msg exportados.

La propiedad GlobalObjectId de la reunión usa el mismo formato que la propiedad CleanGlobalObjectId (por ejemplo, 040000008200E0074C5B7101A82E008000000009421DCCD5046CD0100000000000000000100000000010B0349F6B17454685E17D9F9512E71F) y el valor de las dos propiedades es probablemente el mismo. Sin embargo, es posible que el valor de GlobalObjectId no sea el mismo para todas las instancias de la misma reunión en varios calendarios (por ejemplo, distintos asistentes invitados a instancias diferentes de la misma reunión periódica).

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: Este parámetro se quitó de Exchange 2016 y Exchange 2019 por la Novedades acumulativa de 2022 H1 porque acepta valores de ruta de acceso UNC. Para especificar los elementos de calendario que se van a analizar, use el parámetro CalendarLogs.

Este parámetro solo funciona en Exchange 2013.

El parámetro LogLocation especifica la ubicación de los elementos de calendario exportados que desea analizar. Puede especificar una ruta de acceso local o una ruta de acceso UNC (\\Server\Share\User). Si el valor contiene espacios, escriba el valor entre comillas (").

Los elementos de calendario se exportan a archivos .msg mediante el cmdlet Get-CalendarDiagnosticLog con el parámetro LogLocation. Si la ruta de acceso contiene varios archivos .msg, todos esos archivos se analizan al ejecutar Get-CalendarDiagnosticAnalysis.

No se puede usar este parámetro con el parámetro 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

El parámetro OutputAs especifica el formato de salida del comando. Los valores admitidos son:

• CSV (este es el valor predeterminado)
• 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

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.