Remove-CalendarEvents

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Server 2019, Exchange Online

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 ou outro ambiente.

Use o cmdlet Remove-CalendarEvents para cancelar reuniões futuras em caixas de correio de usuário ou de recursos. Cancelar reuniões futuras os remove dos calendários de participantes e recursos (por exemplo, você vai remover a caixa de correio ou o usuário está saindo de uma licença).

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

Syntax

Remove-CalendarEvents
      [-Identity] <MailboxIdParameter>
      -QueryWindowInDays <Int32>
      [-CancelOrganizedMeetings]
      [-Confirm]
      [-PreviewOnly]
      [-QueryStartDate <ExDateTime>]
      [-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 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

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 em ou 120 dias após a data de hoje. Depois de cancelar as reuniões, você pode remover a caixa de correio.

Exemplo 2

Remove-CalendarEvents -Identity "Angela Gruber" -CancelOrganizedMeetings -QueryStartDate 11-1-2018 -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, então cancelar essas reuniões as remove dos calendários de usuário e recursos durante sua ausência.

Exemplo 3

Remove-CalendarEvents -Identity "Jacob Berger" -CancelOrganizedMeetings -QueryStartDate 9-1-2018 -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

A opção CancelOrganizedMeetings especifica se deve cancelar reuniões 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 essa opção.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2019, Exchange Online

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
A maioria dos outros cmdlets (por exemplo, cmdlets 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 confirmar o comando antes de continuar.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2019, Exchange Online

-Identity

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)
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 2019, Exchange Online

-PreviewOnly

A opção PreviewOnly especifica se deseja visualizar os resultados do comando sem realmente cancelar nenhuma reunião. Não é preciso especificar um valor com essa opção.

Use essa opção com o comutador Verbose.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2019, Exchange Online

-QueryStartDate

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/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".

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.

Type:	ExDateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2019, Exchange Online

-QueryWindowInDays

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 ocorrer uma instância de uma reunião recorrente durante o período de tempo 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 1825 dias (5 anos).

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

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2019, Exchange Online