Get-CalendarDiagnosticLog
Aunque este cmdlet está disponible en Exchange local y en el servicio basado en la nube, solo funciona en Exchange local. En el servicio basado en la nube, use el cmdlet Get-CalendarDiagnosticObjects en su lugar.
Use el cmdlet Get-CalendarDiagnosticLog para recopilar una serie de registros de calendario. Los registros de diagnóstico de calendario realizan un seguimiento de todos los elementos de calendario y las convocatorias de reunión en los buzones de correo. Puede usar esta información para solucionar problemas de calendario que se producen en los buzones de correo.
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-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>] Description
La salida de este cmdlet contiene la siguiente información:
- IsFileLink: indica si el elemento de calendario se ha exportado a un archivo .msg mediante el parámetro LogLocation. Los valores son True o False.
- Identidad: identifica el buzón que contiene el elemento de calendario. Un valor de ejemplo es: excallog://laura@contoso.com/?id=RgAAAACF/h/dHTTkQbdPrk7z+G4SBwCoatc7EmnEQq1iF35p17stAAAAAAFEAACoatc7EmnEQq1iF35p17stAAAAABEIAAAP.
- LogDate: fecha y hora en que se registró el elemento de calendario.
- NormalizedSubject: campo Asunto del elemento de calendario.
- CleanGlobalObjectId: identificador que es constante a lo largo de la duración del elemento de calendario. Por ejemplo, 040000008200E00074C5B7101A82E008000000B0225ABF0710C80100000000000000000010000000005B27C05AA7C4646B0835D5EB4E41C55.
Después de ejecutar el cmdlet Get-CalendarDiagnosticLog, puede analizar los datos de calendario mediante el cmdlet Get-CalendarDiagnosticAnalysis. Para obtener más información, consulte Get-CalendarDiagnosticAnalysis.
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-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "Weekly development meeting" -ExactMatch $trueEn este ejemplo se recuperan las entradas del registro de diagnóstico de calendario para el buzón de Shannon Steele mediante la reunión de desarrollo semanal del asunto.
Ejemplo 2
Get-CalendarDiagnosticLog -Identity oevans -StartDate "6/1/2018 6:00:00 AM" -EndDate "6/30/2018 5:00:00 PM"En este ejemplo se recuperan las entradas de registro de diagnóstico de calendario para el buzón de Oscar Evans del 1/6/2018 al 6/30/2018.
Ejemplo 3
Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Weekly development meeting" -LatestEn este ejemplo se recuperan los datos del registro de diagnóstico de calendario solo para el elemento de calendario más reciente del buzón de Jasen Kozma con un asunto de mensaje de "Reunión de desarrollo semanal".
Ejemplo 4
Get-CalendarDiagnosticLog -Identity "Jasen Kozma" -Subject "Budget Meeting" -ExactMatch $true -LogLocation "C:\My Documents\Calendar Diagnostic Export"En Exchange 2013, este ejemplo exporta todos los elementos de calendario del registro de diagnóstico de calendario del buzón de Jasen Kozma que tienen "Reunión presupuestaria" en cualquier lugar del asunto de la carpeta especificada.
Notas:
- En este ejemplo, los archivos de mensaje se escriben en C:\Mis documentos\Calendar Diagnostic Export\jkozma@contoso.com.
- En las organizaciones de Exchange locales, puede usar el cmdlet Get-CalendarDiagnosticAnalysis para analizar los archivos .msg exportados.
- Este ejemplo no funciona en Exchange 2016 o Exchange 2019 porque el parámetro LogLocation no está disponible.
Parámetros
-Credential
Este parámetro solo está disponible en Exchange local.
El parámetro Credential especifica el nombre de usuario y la contraseña que se usan para ejecutar este comando. Por lo general, este parámetro se usa en scripts o cuando deben proporcionarse credenciales diferentes que disponen de los permisos necesarios.
Un valor para este parámetro requiere el cmdlet Get-Credential. Para pausar este comando y recibir una solicitud de credenciales, use el valor (Get-Credential). O bien, antes de ejecutar este comando, almacene las credenciales en una variable (por ejemplo, $cred = Get-Credential) y, a continuación, use el nombre de variable ($cred) para este parámetro. Para más información, vea 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
Este parámetro solo está disponible en Exchange local.
El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, 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
El parámetro EndDate especifica la fecha de finalización del intervalo de fechas.
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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-EntryId
El parámetro EntryId filtra los resultados por identificador de entrada. 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 Server 2016, Exchange Server 2019, 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 Server 2016, Exchange Server 2019, Exchange Online |
-Identity
El parámetro Identity especifica el buzón que contiene los elementos del calendario. Es posible usar cualquier valor que identifique exclusivamente el buzón. 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: | 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
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.
Solo puede usar este parámetro con el parámetro 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
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 Server 2016, Exchange Server 2019, Exchange Online |
-Latest
El modificador Latest especifica si se devuelven los datos de registro de calendario solamente para el elemento de calendario más reciente. No es necesario especificar un valor con este modificador.
| 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: 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. El uso de este cmdlet ahora está restringido al servidor local.
Este parámetro solo funciona en Exchange 2010 y Exchange 2013.
El parámetro LogLocation especifica la ubicación para exportar los elementos de calendario a los archivos .msg. Puede especificar una ruta de acceso local o una ruta de acceso UNC (\\Server\Share). Si el valor contiene espacios, escriba el valor entre comillas (").
En la ubicación especificada, se crea automáticamente una subcarpeta para el buzón especificado que contiene los elementos de calendario exportados. Por ejemplo, si especifica el valor "C:\My Documents\Calendar Export" para exportar elementos de calendario desde el buzón de Shannon Steele, los archivos .msg se almacenan realmente en C:\My Documents\Calendar Export\ssteele@contoso.com.
En las organizaciones de Exchange locales, puede usar el cmdlet Get-CalendarDiagnosticAnalysis para analizar los archivos .msg exportados.
Nota: Los comandos que usan este parámetro pueden producir un error si el elemento de calendario no tiene un título. Si recibe errores al usar este parámetro, vuelva a ejecutar el comando y reemplace este parámetro por el redireccionamiento a un archivo (| Set-Content -Path "C:\My Documents\Calendar Export") o sustituya la salida por una variable de 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
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.
Para encontrar este valor, es más fácil buscar primero el elemento de calendario mediante los parámetros Subject, StartDate y EndDate. Después de encontrar el elemento de calendario que desee, puede usar su valor CleanGlobalObjectId para el parámetro MeetingID en comandos futuros.
No use este parámetro con el parámetro Subject, porque el valor del parámetro MeetingID tiene prioridad.
| 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
Este parámetro solo está disponible en Exchange local.
El conmutador ReadFromDomainController especifica que la información se debe leer de un controlador de dominio en el dominio del usuario. No es necesario especificar un valor con este modificador.
El comando : Set-AdServerSettings -ViewEntireForest $true para incluir todos los objetos en el bosque, es necesario el modificador ReadFromDomainController. De lo contrario, el comando podría usar un catálogo global que contenga información obsoleta. Además, es posible que tenga que ejecutar varias iteraciones del comando con el modificador ReadFromDomainController para obtener la información.
De forma predeterminada, el ámbito del destinatario se establece en el dominio que hospeda los servidores de 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
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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-StartDate
El parámetro StartDate especifica la fecha de inicio del intervalo de fechas.
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 Server 2013, Exchange Server 2016, Exchange Server 2019, 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, escriba el valor entre comillas ("). Puede controlar si se debe usar la coincidencia exacta mediante el parámetro ExactMatch.
No use este parámetro con el parámetro MeetingID, porque el valor del parámetro MeetingID tiene prioridad.
| 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 |
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.