Compartir a través de


Get-CalendarDiagnosticObjects

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet Get-CalendarDiagnosticObjects para recopilar un intervalo de registros de calendario. Los registros de diagnóstico de calendario realizan un seguimiento de los datos de eventos importantes relacionados con el calendario para cada buzón y se pueden usar para solucionar problemas de calendario que se producen en los buzones de correo. Los registros realizan un seguimiento de todos los elementos del calendario y los mensajes de reunión.

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-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>]

Description

Algunas de las propiedades más interesantes que se devuelven en los resultados son:

  • AppointmentState: 1 = La cita es una reunión, 2 = Se ha recibido la cita, 4 = Se ha cancelado la cita y 8 = la cita es una cita reenviada.
  • CalendarLogTriggerAction: la acción que se realiza en el elemento (por ejemplo, Crear o Actualizar).
  • ClientInfoString: la entidad que realizó el cambio (por ejemplo, Client=OWA;<AdditionalDetails>, Client=WebServices;<AdditionalDetails>;o Client=TBA;Service=MSExchangeMailboxAssistants;Action=ELCAssistant;).
  • MeetingRequestType: 1 = El mensaje de reunión es una convocatoria de reunión, 65536 = El mensaje de reunión es una actualización completa de una reunión existente, 131072 = El mensaje de reunión es una actualización informativa de una reunión existente, 262144 = El mensaje de reunión es una actualización silenciosa, 524288 = La actualización está obsoleta o 1048576 = El mensaje de reunión se reenvía a un delegado, y la copia se marca como informativa.
  • OriginalLastModifiedTime: se usa como campo de ordenación principal para ordenar los eventos.
  • ResponseType: 0 = El organizador no ha recibido una respuesta, 1 = La copia del organizador de la reunión, 2 = Provisional, 3 = Aceptar, 4 = Rechazar o 5 = El asistente no ha respondido.
  • ResponsibleUserName: valor de LegacyExchangeDN del usuario que realizó el cambio (por ejemplo, /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).

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

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

En este ejemplo se recuperan los registros de diagnóstico del calendario del buzón de Pedro Pizarro para todos los elementos en los que el asunto es una coincidencia exacta para la reunión de equipo.

Ejemplo 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

Esto es lo mismo que en el ejemplo anterior, pero ahora los resultados se ordenan por la hora original de la última modificación.

Ejemplo 3

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

En este ejemplo se recuperan los registros de diagnóstico del calendario del buzón de Pedro Pizarro para una reunión con el identificador de objeto global (GOID) único especificado.

Ejemplo 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

En este ejemplo se devuelve información de diagnóstico para las reuniones con el asunto Team Lunch en el buzón de Pedro Pizarro que se modificaron en el mes de julio de 2018 y se exportan los resultados al archivo C:\My Documents\Team Lunch Meeting.csv.

Parámetros

-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

El parámetro CustomPropertyNames devuelve la propiedad personalizada del elemento de calendario especificada en los resultados. Para obtener valores válidos, vea Valores para el parámetro CustomPropertyNames en Exchange Online PowerShell.

Puede especificar distintos valores separados por comas.

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

-EndDate

El parámetro EndDate especifica la fecha de finalización del intervalo de fechas de la propiedad OriginalLastModifiedTime (cuando la reunión se modificó por última vez, no se creó).

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".

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

-EntryId

El parámetro EntryID filtra los resultados por el valor de propiedad EntryID especificado, que corresponde a la propiedad 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

El parámetro ExactMatch especifica si se debe usar una coincidencia exacta o una coincidencia parcial para los valores de texto que especifique para el parámetro Subject. Los valores admitidos son:

  • $true: la búsqueda del asunto usa una coincidencia exacta y busca en todos los elementos del calendario del buzón. Por ejemplo, si busca "presupuesto", la búsqueda busca elementos que tengan "presupuesto" en cualquier lugar del asunto, pero no "presupuestación".
  • $false: la búsqueda del asunto usa una coincidencia parcial y busca un máximo de 1000 elementos de calendario en el buzón. Por ejemplo, si busca "presupuesto", la búsqueda busca elementos que tengan "presupuesto" y "presupuestación" en cualquier lugar del asunto. Este es el valor predeterminado.

Es posible que una búsqueda parcial de coincidencias de asuntos no devuelva todos los elementos de calendario pertinentes. Pruebe a usar una búsqueda exacta de coincidencias de asuntos para obtener resultados más precisos.

Este parámetro solo se usa con el parámetro Subject.

El valor de este parámetro se omite cuando se usa el parámetro MeetingId.

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

-Identity

El parámetro Identity especifica el buzón o grupo de Microsoft 365 cuyo calendario desea ver. Puede usar cualquier valor que identifique de forma única el buzón o el grupo de Microsoft 365. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre completo (DN)
  • Dominio\Nombre de usuario
  • Dirección de correo electrónico
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuario o nombre de la entidad de seguridad de usuario (UPN)
Type:UnifiedGroupOrUserMailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-ItemClass

El parámetro ItemClass filtra los resultados por el valor de propiedad MessageClass especificado del elemento de calendario (por ejemplo, IPM. Cita). Puede especificar distintos valores separados por comas.

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

-ItemIds

El parámetro ItemIds filtra los resultados por identificador de elemento. Puede especificar distintos valores separados por comas.

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

El parámetro MeetingId filtra los resultados por el identificador único global del elemento de calendario. El valor es la propiedad CleanGlobalObjectId del elemento de calendario que está disponible en la salida de este cmdlet o mediante otras herramientas de examen MAPI. Un valor de ejemplo es 040000008200E00074C5B7101A82E008000000B0225ABF0710C80100000000000000000010000000005B27C05AA7C4646B0835D5EB4E41C55. Este valor es constante durante toda la duración del elemento de 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

Este parámetro determina el número de resultados devueltos por el cmdlet . El valor máximo es 1000.

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

-ShouldBindToItem

El parámetro ShouldBindToItem especifica si se truncan valores de propiedad de gran tamaño que se pueden transmitir (por ejemplo, AppointmentRecurrenceBlob). Los valores admitidos son:

  • $true: los valores de las propiedades que se pueden transmitir de gran tamaño no se truncan, por lo que se devuelve el valor completo.
  • $false: los valores de las propiedades que se pueden transmitir grandes se truncan. Este es el valor predeterminado.
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

El parámetro ShouldFetchRecurrenceExceptions especifica si se deben incluir excepciones a reuniones periódicas. Los valores admitidos son:

  • $true: incluir excepciones a reuniones periódicas. Cuando se usa este valor, también debe usar el parámetro ItemIds.
  • $false: No incluya excepciones a reuniones periódicas. Este es el valor predeterminado.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-StartDate

El parámetro StartDate especifica la fecha de inicio del intervalo de fechas de la propiedad OriginalLastModifiedTime (cuando la reunión se modificó por última vez, no se creó).

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".

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

-Subject

El parámetro Subject identifica los elementos de calendario por el texto especificado en el campo Asunto. Los valores de texto que especifique no distinguen mayúsculas de minúsculas. Si el valor contiene espacios, escríbalo entre comillas. Puede controlar si se debe usar la coincidencia exacta mediante el parámetro ExactMatch.

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