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 de Calendário acompanham todos os itens de calendário e solicitações de reunião em caixas de correio. Você pode usar essas informações para solucionar problemas de calendário que ocorrem em caixas de correio.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
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
A saída deste cmdlet contém as seguintes informações:
- IsFileLink: indica se o item de calendário foi 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+G4SBwCoatc7EmnEQq1iF35p17stAAAAAAAAAFEAACoatc7EmnEQ1iF35p17stAAAABEIAAAP.
- LogDate: a data-hora em que o item do calendário foi registrado.
- NormalizedSubject: o campo Assunto do item calendário.
- CleanGlobalObjectId: o identificador que é constante durante todo o tempo de vida do item de calendário. Por exemplo, 04000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000000100000005B27C05AA7C4646B0835D5EB4E41C55.
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 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-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "Weekly development meeting" -ExactMatch $trueEste exemplo recupera as entradas de log de diagnóstico de calendário para a caixa de correio de Shannon Steele usando a reunião de desenvolvimento semanal do assunto.
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 de Calendário para a caixa de correio de Oscar Evans de 1/06/2018 a 30/06/2018.
Exemplo 3
Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Weekly development meeting" -LatestEste exemplo recupera os dados de log de Diagnóstico de Calendário 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 de calendário para a caixa de correio de Jasen Kozma que têm "Reunião de Orçamento" em qualquer lugar no assunto para a 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 nem no Exchange 2019 porque o parâmetro LogLocation não está disponível.
Parâmetros
-Credential
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.
| 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 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.
| 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
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/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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-EntryId
O parâmetro EntryId filtra os resultados por ID de entrada. 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 Server 2016, Exchange Server 2019, 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 Server 2016, Exchange Server 2019, Exchange Online |
-Identity
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)
- Domain\username
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome 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
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.
Você só pode usar esse parâmetro com o 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
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 Server 2016, Exchange Server 2019, Exchange Online |
-Latest
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.
| 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
Observação: esse parâmetro foi removido do Exchange 2016 e do Exchange 2019 pelo Atualizações Cumulativo H1 2022 porque aceita valores de caminho UNC. O uso desse cmdlet agora está restrito ao servidor local.
Esse parâmetro é funcional apenas no Exchange 2010 e no Exchange 2013.
O parâmetro LogLocation especifica o local para exportar os itens de calendário para arquivos .msg. 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:\My Documents\Calendar Export" para exportar itens de calendário da caixa de correio de Shannon Steele, os arquivos .msg serão armazenados em C:\My Documents\Calendar Export\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 podem 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 por redirecionamento para um arquivo (| Set-Content -Path "C:\My Documents\Calendar Export") ou substitua a saída por uma variável do 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
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.
Para localizar esse valor, é mais fácil primeiro pesquisar o item de calendário usando os parâmetros Assunto, StartDate e EndDate. Depois de encontrar o item de calendário desejado, você pode usar o 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.
| 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 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 pode 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 do 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
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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-StartDate
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/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 Server 2013, Exchange Server 2016, Exchange Server 2019, 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.
Não use esse parâmetro com o parâmetro MeetingID, pois o valor do parâmetro MeetingID tem precedência.
| 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 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.
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários