Remove-CalendarEvents
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ambiente ou de outro.
Use o cmdlet Remove-CalendarEvents para cancelar reuniões futuras nas caixas de correio do usuário ou do recurso. O cancelamento de reuniões futuras as remove dos calendários de participantes e recursos (por exemplo, você removerá a caixa de correio ou o usuário estará de licença).
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Remove-CalendarEvents
[-Identity] <MailboxIdParameter>
-QueryWindowInDays <Int32>
[-CancelOrganizedMeetings]
[-Confirm]
[-PreviewOnly]
[-QueryStartDate <ExDateTime>]
[-UseCustomRouting]
[-WhatIf]
[<CommonParameters>]
Description
Esse cmdlet cancela reuniões na caixa de correio especificada em que a caixa de correio é o organizador da reunião e a reunião tem um ou mais participantes ou recursos. Ele não cancela compromissos ou reuniões sem participantes ou recursos. Como os cancelamentos de reunião devem ser enviados, a caixa de correio ainda deve estar habilitada para enviar emails.
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
Remove-CalendarEvents -Identity chris@contoso.com -CancelOrganizedMeetings -QueryWindowInDays 120
Este exemplo cancela todas as reuniões na caixa de correio chris@contoso.com que ocorrem na data de hoje ou 120 dias depois. Depois de cancelar as reuniões, você pode remover a caixa de correio.
Exemplo 2
Remove-CalendarEvents -Identity "Angela Gruber" -CancelOrganizedMeetings -QueryStartDate 11-30-2025 -QueryWindowInDays 120
Este exemplo cancela as reuniões no calendário de Angela Gruber para o intervalo de datas especificado. Angela está tirando uma licença temporária da empresa, portanto, cancelar essas reuniões as remove dos calendários de usuários e recursos durante sua ausência.
Exemplo 3
Remove-CalendarEvents -Identity "Jacob Berger" -CancelOrganizedMeetings -QueryStartDate 11-30-2025 -QueryWindowInDays 90 -PreviewOnly -Verbose
Este exemplo visualiza as reuniões que seriam canceladas no calendário de Jacob Berger para o intervalo de datas especificado. Nenhuma alteração é feita na caixa de correio.
Parâmetros
-CancelOrganizedMeetings
Aplicável: Exchange Server 2019, Exchange Server SE, Exchange Online
A opção CancelOrganizedMeetings especifica se as reuniões devem ser canceladas na caixa de correio. Não é preciso especificar um valor com essa opção.
Para cancelar reuniões na caixa de correio, você precisa usar esta opção.
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 |
-Confirm
Aplicável: Exchange Server 2019, Exchange Server SE, Exchange Online
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
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 |
-Identity
Aplicável: Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Identity especifica a caixa de correio que você deseja modificar. É 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
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: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-PreviewOnly
Aplicável: Exchange Server 2019, Exchange Server SE, Exchange Online
A opção PreviewOnly especifica se os resultados do comando devem ser visualizados sem realmente cancelar nenhuma reunião. Não é preciso especificar um valor com essa opção.
Você usa essa opção com a opção Detalhado.
Observação: a saída deste cmdlet sempre informa que todas as reuniões existentes estão na fila para cancelamento. Mas se você usar essa opção, as reuniões não serão canceladas.
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 |
-QueryStartDate
Aplicável: Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro QueryStartDate especifica a data de início para procurar reuniões que você deseja cancelar.
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".
Observação: se você não usar esse parâmetro, a data de hoje será usada.
Você usa o parâmetro QueryWindowInDays para especificar a data de término.
Propriedades do parâmetro
| Tipo: | ExDateTime |
| 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 |
-QueryWindowInDays
Aplicável: Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro QueryWindowInDays especifica o número de dias após o valor do parâmetro QueryStartDate para procurar reuniões que você deseja cancelar.
Se uma instância de uma reunião recorrente ocorrer durante o período especificado, toda a série será cancelada (não apenas as instâncias durante o período de tempo).
Observação: a janela máxima permitida para cancelamento de reunião é de 1.825 dias (5 anos).
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UseCustomRouting
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Preencher descrição do UseCustomRouting }}
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 |
-WhatIf
Aplicável: Exchange Server 2019, Exchange Server SE, Exchange Online
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. 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 |
| Aliases: | wi |
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 |
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.