Get-CalendarDiagnosticObjects

Módulo:
Exchange PowerShell

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 del calendario realizan un seguimiento de los datos importantes de eventos relacionados con el calendario de cada buzón y se pueden usar para solucionar problemas 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.

Sintaxis

Default (valor predeterminado) 

Get-CalendarDiagnosticObjects
    [-Identity] <UnifiedGroupOrUserMailboxIdParameter>
    [-AnalyzeExceptionWithOriginalStartDate <ExDateTime>]
    [-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>]
    [-ShouldResolveParticipants <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 recibe la cita, 4 = se cancela 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 el campo de ordenación principal para ordenar los eventos.
  • ResponseType: 0 = El organizador no ha recibido una respuesta, 1 = La copia de la reunión del organizador, 2 = Provisional, 3 = Aceptar, 4 = Rechazar o 5 = El asistente no ha respondido.
  • ResponsibleUserName: el 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 artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que tiene asignados. 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 coincide exactamente con 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

Es lo mismo que en el ejemplo anterior, pero ahora los resultados se ordenan por 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 ID. de objeto global único (GOID) 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 diagnóstica de las reuniones con el sujeto Almuerzo de equipo 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:\Mis documentos\Almuerzo de equipo Meeting.csv.

Parámetros

-AnalyzeExceptionWithOriginalStartDate

Aplicable: Exchange Online

{{ Fill AnalyzeExceptionWithOriginalStartDate Description }}

Propiedades de parámetro

Tipo:ExDateTime
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AutoRequeryOnMeetingId

Aplicable: Exchange Online

{{ fill AutoRequeryOnMeetingId Description }}

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ConfigurationName

Aplicable: Exchange Online

{{ Fill ConfigurationName Description }}

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CustomPropertyNames

Aplicable: Exchange Online

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

Puede especificar distintos valores separados por comas.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EndDate

Aplicable: Exchange Online

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

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/aaaa, 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".

Propiedades de parámetro

Tipo:ExDateTime
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EntryId

Aplicable: Exchange Online

El parámetro EntryID filtra los resultados por el valor de propiedad EntryID especificado, que corresponde a la propiedad MAPI PR_ENTRYID.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EwsId

Aplicable: Exchange Online

{{ Fill EwsId Description }}

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ExactMatch

Aplicable: Exchange Online

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

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

Es posible que una búsqueda de coincidencia parcial de asunto no devuelva todos los elementos de calendario relevantes. Intente usar una búsqueda de coincidencia exacta de asunto para obtener resultados más precisos.

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

El valor de este parámetro se ignora al usar el parámetro MeetingId.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: Exchange Online

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)

Precaución: El valor $null o un valor inexistente para el parámetro Identity devuelve todos los objetos como si ejecutara el comando Get- sin el parámetro Identity. Compruebe que las listas de valores para el parámetro Identidad sean precisas y no contengan valores $null inexistentes.

Propiedades de parámetro

Tipo:UnifiedGroupOrUserMailboxIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ItemClass

Aplicable: Exchange Online

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

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ItemIds

Aplicable: Exchange Online

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

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MaxResults

Aplicable: Exchange Online

{{ Fill MaxResults Description }}

Propiedades de parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MeetingId

Aplicable: Exchange Online

El parámetro MeetingId filtra los resultados por el identificador único y 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 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55. Este valor es constante durante toda la vida útil del elemento de calendario.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ODataId

Aplicable: Exchange Online

{{ Fill ODataId Description }}

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResultSize

Aplicable: Exchange Online

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

Propiedades de parámetro

Tipo:Unlimited
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ShouldBindToItem

Aplicable: Exchange Online

El parámetro ShouldBindToItem especifica si se truncan valores de propiedad transmitibles grandes (por ejemplo, AppointmentRecurrenceBlob). Los valores admitidos son:

  • $true: Los valores de las propiedades de gran tamaño no se truncan, por lo que se devuelve el valor completo.
  • $false: Se truncan los valores de las propiedades de transmisión de gran tamaño. Este valor es el predeterminado.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ShouldDecodeEnums

Aplicable: Exchange Online

{{ Fill ShouldDecodeEnums Description }}

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ShouldFetchAttendeeCollection

Aplicable: Exchange Online

{{ fill ShouldFetchAttendeeCollection Description }}

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ShouldFetchRecurrenceExceptions

Aplicable: Exchange Online

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

  • $true: Incluir excepciones a las reuniones periódicas. Cuando usa este valor, también necesita usar el parámetro ItemIds.
  • $false: No incluya excepciones a reuniones periódicas. Este valor es el predeterminado.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ShouldResolveParticipants

Aplicable: Exchange Online

{{ Fill ShouldResolveParticipants Description }}

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-StartDate

Aplicable: Exchange Online

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

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/aaaa, 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".

Propiedades de parámetro

Tipo:ExDateTime
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Subject

Aplicable: Exchange Online

El parámetro Subject identifica los elementos de calendario por el texto especificado en el campo Subject. 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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.