Get-CalendarDiagnosticLog
Embora esse cmdlet esteja disponível no Exchange local e no serviço baseado em nuvem, ele só funciona no Exchange local. No serviço baseado em nuvem, use o cmdlet Get-CalendarDiagnosticObjects.
Use o cmdlet Get-CalendarDiagnosticLog para coletar uma gama de logs do calendário. Os logs de Diagnóstico do Calendar rastreiam todos os itens de calendário e solicitações de reunião nas caixas de correio. Você pode usar essas informações para solucionar problemas de calendário que ocorrem nas caixas de correio.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
MeetingId
Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-MeetingID <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-LogLocation <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[<CommonParameters>]
MeetingSubject
Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-Subject <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-LogLocation <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[<CommonParameters>]
ExportToMsg
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
A saída desse cmdlet contém as seguintes informações:
- IsFileLink: indica se o item de calendário é exportado para um arquivo .msg usando o parâmetro LogLocation. Os valores são True ou False.
- Identidade: identifica a caixa de correio que contém o item de calendário. Um valor de exemplo é: excallog://laura@contoso.com/?id=RgAAAACF/h/dHTTkQbdPrk7z+G4SBwCoatc7EmnEQq1iF35p17stAAAAAAFEAACoatc7EmnEQq1iF35p17stAAAAABEIAAAP.
- LogDate: a data/hora em que o item de calendário foi registrado.
- NormalizedSubject: o campo Assunto do item de calendário.
- CleanGlobalObjectId: o identificador que é constante durante todo o tempo de vida do item de calendário. Por exemplo, 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55.
Depois de executar o cmdlet Get-CalendarDiagnosticLog, você pode analisar os dados de calendário utilizando o cmdlet Get-CalendarDiagnosticAnalysis. Para obter mais informações, consulte Get-CalendarDiagnosticAnalysis.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "Weekly development meeting" -ExactMatch $true
Este exemplo recupera as entradas de log de diagnóstico do Calendar para a caixa de correio de Shannon Steele usando o assunto Reunião semanal de desenvolvimento.
Exemplo 2
Get-CalendarDiagnosticLog -Identity oevans -StartDate "6/1/2018 6:00:00 AM" -EndDate "6/30/2018 5:00:00 PM"
Este exemplo recupera as entradas de log de Diagnóstico do Calendar para a caixa de correio de Oscar Evans de 01/06/2018 a 30/06/2018.
Exemplo 3
Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Weekly development meeting" -Latest
Este exemplo recupera os dados de log do Diagnóstico do Calendar apenas para o item de calendário mais recente na caixa de correio de Jasen Kozma com um assunto de mensagem de "Reunião de desenvolvimento semanal".
Exemplo 4
Get-CalendarDiagnosticLog -Identity "Jasen Kozma" -Subject "Budget Meeting" -ExactMatch $true -LogLocation "C:\My Documents\Calendar Diagnostic Export"
No Exchange 2013, este exemplo exporta todos os itens de calendário no log de diagnóstico do Calendar para a caixa de correio de Jasen Kozma que têm "Reunião de orçamento" em qualquer lugar no assunto da pasta especificada.
Observações:
- Neste exemplo, os arquivos de mensagem são gravados em C:\My Documents\Calendar Diagnostic Export\jkozma@contoso.com.
- Em organizações locais do Exchange, você pode usar o cmdlet Get-CalendarDiagnosticAnalysis para analisar os arquivos .msg exportados.
- Este exemplo não funciona no Exchange 2016 ou no Exchange 2019 porque o parâmetro LogLocation não está disponível.
Parâmetros
-Credential
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro Credential especifica o nome de usuário e a senha usados para executar esse comando. Normalmente, você usa esse parâmetro em scripts ou quando você precisa fornecer credenciais diferentes que têm as permissões necessárias.
Um valor para esse parâmetro requer o cmdlet Get-Credential. Para pausar o comando e receber uma solicitação de credenciais, use o valor (Get-Credential). Ou, antes de executar esse comando, armazene as credenciais em uma variável (por exemplo, $cred = Get-Credential) e, em seguida, use o nome da variável ($cred) para esse parâmetro. Para saber mais, confira Obter credencial.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-EndDate
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro EndDate especifica a data de término do intervalo de datas.
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/aaaa, 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".
Propriedades do parâmetro
| Tipo: | ExDateTime |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ExportToMsg
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-EntryId
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro EntryId filtra os resultados por ID de entrada. Vários valores, separados por vírgulas, podem ser especificados.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ExportToMsg
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExactMatch
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro ExactMatch especifica se uma correspondência exata ou parcial deve ser usada 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 "orçamento", a pesquisa procurará itens que tenham "orçamento" em qualquer lugar no assunto, mas não "orçamento".
- $false: A pesquisa de assunto usa uma correspondência parcial e pesquisa no máximo 1.000 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 no assunto. Esse valor é o 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 exata de assunto 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.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ExportToMsg
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Identity especifica a caixa de correio que contém os itens de calendário. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- Domínio\Nome de usuário
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | MailboxIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ItemClass
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro ItemClass filtra os resultados pelo valor da propriedade MessageClass especificado do item de calendário (por exemplo, IPM. Nomeação). Vários valores, separados por vírgulas, podem ser especificados.
Você só pode usar esse parâmetro com o parâmetro MeetingID.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ExportToMsg
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ItemIds
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro ItemIds filtra os resultados por ID do item. Vários valores, separados por vírgulas, podem ser especificados.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ExportToMsg
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Latest
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção Latest especifica se deve ser retornado apenas o item mais recente do calendário dos dados de registro do calendário. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ExportToMsg
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-LogLocation
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Online
Observação: esse parâmetro foi removido do Exchange 2016 e do Exchange 2019 pelas Atualizações Cumulativas do S1 de 2022 porque aceita valores de caminho UNC. O uso deste cmdlet agora está restrito ao servidor local.
Esse parâmetro é funcional somente no Exchange 2010 e no Exchange 2013.
O parâmetro LogLocation especifica o local para exportar os itens de calendário para .msg arquivos. Você pode especificar um caminho local ou um caminho UNC (\\Server\Share). Se o valor contiver espaços, coloque-o entre aspas (").
No local especificado, uma subpasta é criada automaticamente para a caixa de correio especificada que contém os itens de calendário exportados. Por exemplo, se você especificar o valor "C:\Meus Documentos\Calendar Exportar" para exportar itens de calendário da caixa de correio de Shannon Steele, os arquivos .msg serão realmente armazenados em C:\Meus Documentos\Calendar Exportar\ssteele@contoso.com.
Em organizações locais do Exchange, você pode usar o cmdlet Get-CalendarDiagnosticAnalysis para analisar os arquivos .msg exportados.
Observação: os comandos que usam esse parâmetro poderão falhar se o item de calendário não tiver um título. Se você receber erros ao usar esse parâmetro, execute o comando novamente e substitua esse parâmetro pelo redirecionamento para um arquivo (| Set-Content -Path "C:\My Documents\Calendar Export") ou substitua a saída por uma variável do PowerShell.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ExportToMsg
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
MeetingId
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
MeetingSubject
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MeetingID
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro MeetingID filtra os resultados pelo identificador global exclusivo do item de calendário. O valor é a propriedade CleanGlobalObjectId do item de calendário que está disponível na saída desse cmdlet ou usando outras ferramentas de exame MAPI. Um valor de exemplo é 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55. Esse valor é constante durante todo o tempo de vida do item de calendário.
Para localizar esse valor, é mais fácil pesquisar primeiro o item de calendário usando os parâmetros Subject, StartDate e EndDate. Depois de encontrar o item de calendário desejado, você pode usar seu valor CleanGlobalObjectId para o parâmetro MeetingID em comandos futuros.
Não use esse parâmetro com o parâmetro Subject, pois o valor do parâmetro MeetingID tem precedência.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
MeetingId
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
ExportToMsg
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ReadFromDomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
A opção ReadFromDomainController especifica se as informações devem ser lidas de um controlador de domínio no domínio do usuário. Não é preciso especificar um valor com essa opção.
O comando: Set-AdServerSettings -ViewEntireForest $true para incluir todos os objetos na floresta requer a opção ReadFromDomainController. Caso contrário, o comando poderá usar um catálogo global que contém informações desatualizadas. Além disso, talvez seja necessário executar várias iterações do comando com a opção ReadFromDomainController para obter as informações.
Por padrão, o escopo do destinatário é definido como o domínio que hospeda seus servidores Exchange.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ResultSize
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Esse parâmetro determina o número de resultados retornados pelo cmdlet. O valor máximo é 1000.
Propriedades do parâmetro
| Tipo: | Unlimited |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-StartDate
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro StartDate especifica a data de início do intervalo de datas.
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/aaaa, 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".
Propriedades do parâmetro
| Tipo: | ExDateTime |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ExportToMsg
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Subject
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Assunto identifica os itens de calendário pelo texto especificado no campo Assunto. Os valores de texto especificados não diferenciam maiúsculas de minúsculas. Se o valor contiver espaços, coloque-o entre aspas ("). Você pode controlar se deseja usar a correspondência exata usando o parâmetro ExactMatch.
Não use esse parâmetro com o parâmetro MeetingID, pois o valor do parâmetro MeetingID tem precedência.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
MeetingSubject
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
ExportToMsg
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.