Get-CalendarDiagnosticObjects

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o cmdlet Get-CalendarDiagnosticObjects para coletar um intervalo de logs de calendário. Os logs de diagnóstico de calendário acompanham dados importantes de eventos relacionados ao calendário para cada caixa de correio e podem ser usados para solucionar problemas de calendário que ocorrem em caixas de correio. Os logs registram todos os itens de calendário e mensagens de reuniões.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

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

Algumas das propriedades mais interessantes retornadas nos resultados são:

  • AppointmentState: 1 = O compromisso é uma reunião, 2 = O compromisso foi recebido, 4 = O compromisso foi cancelado e 8 = o compromisso é um compromisso encaminhado.
  • CalendarLogTriggerAction: a ação tomada no item (por exemplo, Criar ou Atualizar).
  • ClientInfoString: a entidade que fez a alteração (por exemplo, Client=OWA;<AdditionalDetails>, ; Client=WebServices;<AdditionalDetails>ou Client=TBA;Service=MSExchangeMailboxAssistants;Action=ELCAssistant;).
  • MeetingRequestType: 1 = A mensagem de reunião é uma solicitação de reunião, 65536 = A mensagem de reunião é uma atualização completa para uma reunião existente, 131072 = A mensagem de reunião é uma atualização informativa para uma reunião existente, 262144 = A mensagem de reunião é uma atualização silenciosa, 524288 = A atualização está desatualizada ou 1048576 = A mensagem de reunião é encaminhada a um delegado, e a cópia é marcada como informativa.
  • OriginalLastModifiedTime: usado como o campo de classificação primária para ordenar os eventos.
  • ResponseType: 0 = O organizador não recebeu uma resposta, 1 = A cópia do organizador da reunião, 2 = Provisória, 3 = Aceitar, 4 = Declínio ou 5 = O participante não respondeu.
  • ResponsibleUserName: o valor LegacyExchangeDN do usuário que fez a alteração (por exemplo, /o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=BN6PR11MB1587/cn=Microsoft System Attendant ou /o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=696eea97d3c449eab648920d03385efb-admin).

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

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

Este exemplo recupera os logs de diagnóstico de calendário da caixa de correio de Pedro Pizarro para todos os itens em que o Assunto é uma correspondência exata para Reunião de Equipe.

Exemplo 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

Isso é o mesmo que o exemplo anterior, mas agora os resultados são classificados pela última vez modificada original.

Exemplo 3

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

Este exemplo recupera os logs de diagnóstico de calendário da caixa de correio de Pedro Pizarro para uma reunião com a ID de objeto global exclusiva especificada (GOID).

Exemplo 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

Este exemplo retorna informações de diagnóstico para reuniões com o assunto Almoço da Equipe na caixa de correio de Pedro Pizarro que foram modificadas no mês de julho de 2018 e exporta os resultados para o arquivo C:\My Documents\Team Lunch Meeting.csv.

Parâmetros

-AutoRequeryOnMeetingId

{{ Preencher 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

O parâmetro CustomPropertyNames retorna a propriedade personalizada do item de calendário especificado nos resultados. Para valores válidos, consulte Valores para o parâmetro CustomPropertyNames no Exchange Online PowerShell.

Vários valores, separados por vírgulas, podem ser especificados.

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

-EndDate

O parâmetro EndDate especifica a data de término do intervalo de datas para a propriedade OriginalLastModifiedTime (quando a reunião foi modificada pela última vez, não criada).

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "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 Online

-EntryId

O parâmetro EntryID filtra os resultados pelo valor de propriedade EntryID especificado, que corresponde à propriedade 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

{{ Preencher Descrição EwsId }}

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

-ExactMatch

O parâmetro ExactMatch especifica se é necessário usar uma correspondência exata ou uma correspondência parcial para valores de texto especificados para o parâmetro Subject. Os valores válidos são:

  • $true: a pesquisa de assunto usa uma correspondência exata e pesquisa todos os itens de calendário na caixa de correio. Por exemplo, se você pesquisar por "orçamento", a pesquisa procurará itens que tenham "orçamento" em qualquer lugar do assunto, mas não "orçamento".
  • $false: a pesquisa de assunto usa uma correspondência parcial e pesquisa um máximo de 1000 itens de calendário na caixa de correio. Por exemplo, se você pesquisar por "orçamento", a pesquisa procurará itens que tenham "orçamento" e "orçamento" em qualquer lugar do assunto. Esse é o valor padrão.

Uma pesquisa parcial de correspondência de assunto pode não retornar todos os itens de calendário relevantes. Tente usar uma pesquisa de correspondência de assunto exata para obter resultados mais precisos.

Você só usa esse parâmetro com o parâmetro Subject.

O valor desse parâmetro é ignorado quando você usa o 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

O parâmetro Identity especifica a caixa de correio ou o Grupo microsoft 365 cujo calendário você deseja exibir. Você pode usar qualquer valor que identifique exclusivamente a caixa de correio ou o Grupo do Microsoft 365. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN
Type:UnifiedGroupOrUserMailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-ItemClass

O parâmetro ItemClass filtra os resultados pelo valor de propriedade MessageClass especificado do item calendário (por exemplo, IPM. Compromisso). Vários valores, separados por vírgulas, podem ser especificados.

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

-ItemIds

O parâmetro ItemIds filtra os resultados por ID do item. Vários valores, separados por vírgulas, podem ser especificados.

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

-MaxResults

{{ Preenchimento MaxResults Description }}

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

-MeetingId

O parâmetro MeetingId filtra os resultados pelo identificador globalmente exclusivo do item de calendário. O valor é a propriedade CleanGlobalObjectId do item de calendário disponível na saída desse cmdlet ou usando outras ferramentas de exame MAPI. Um valor de exemplo é 04000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000000100000005B27C05AA7C4646B0835D5EB4E41C55. Esse valor é constante durante todo o tempo de vida do item de calendário.

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

-ODataId

{{ Preencher Descrição do ODataId }}

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

-ResultSize

Esse parâmetro determina o número de resultados retornados pelo cmdlet. O valor máximo é 1000.

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

-ShouldBindToItem

O parâmetro ShouldBindToItem especifica se deve truncar grandes valores de propriedade streamable (por exemplo, AppointmentRecurrenceBlob). Os valores válidos são:

  • $true: os valores de grandes propriedades fluíveis não são truncados, portanto, o valor completo é retornado.
  • $false: os valores de grandes propriedades fluíveis são truncados. Esse é o valor padrão.
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

{{ Preenchimento DeveFetchAttendeeCollection Description }}

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

-ShouldFetchRecurrenceExceptions

O parâmetro ShouldFetchRecurrenceExceptions especifica se deve incluir exceções a reuniões recorrentes. Os valores válidos são:

  • $true: inclua exceções a reuniões recorrentes. Ao usar esse valor, você também precisa usar o parâmetro ItemIds.
  • $false: não inclua exceções a reuniões recorrentes. Esse é o valor padrão.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-StartDate

O parâmetro StartDate especifica a data de início do intervalo de datas para a propriedade OriginalLastModifiedTime (quando a reunião foi modificada pela última vez, não criada).

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "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 Online

-Subject

O parâmetro Subject identifica os itens de calendário pelo texto especificado no campo Assunto. Os valores de texto especificados não são sensíveis a casos. Se o valor contiver espaços, coloque-o entre aspas. Você pode controlar se deve usar a correspondência exata usando o parâmetro ExactMatch

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