Remove-CalendarEvents

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Server 2019, Exchange Online

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Используйте командлет Remove-CalendarEvents для отмены будущих собраний в почтовых ящиках пользователей или ресурсов. Отмена будущих собраний удаляет их из календарей участников и ресурсов (например, если вы собираетесь удалить почтовый ящик или пользователь уходит в отпуск).

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Remove-CalendarEvents
      [-Identity] <MailboxIdParameter>
      -QueryWindowInDays <Int32>
      [-CancelOrganizedMeetings]
      [-Confirm]
      [-PreviewOnly]
      [-QueryStartDate <ExDateTime>]
      [-WhatIf]
      [<CommonParameters>]

Описание

Этот командлет отменяет собрания в указанном почтовом ящике, который принадлежит организатору собрания, а собрание включает хотя бы одного участника или хотя бы один ресурс. Он не отменяет встречи или собрания без участников и ресурсов. Так как отмены собраний должны быть отправлены, почтовый ящик по-прежнему должен быть включен для отправки почты.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Remove-CalendarEvents -Identity chris@contoso.com -CancelOrganizedMeetings -QueryWindowInDays 120

Этот пример отменяет каждое собрание в почтовом ящике chris@contoso.com , которое происходит на 120 дней после сегодняшней даты или через 120 дней. После отмены собраний вы можете удалить почтовый ящик.

Пример 2

Remove-CalendarEvents -Identity "Angela Gruber" -CancelOrganizedMeetings -QueryStartDate 11-1-2018 -QueryWindowInDays 120

В этом примере отменяются собрания в календаре пользователя Angela Gruber в указанном диапазоне дат. Angela уходит в отпуск, поэтому отмена этих собраний удалит их из календарей пользователя и ресурсов на время ее отсутствия.

Пример 3

Remove-CalendarEvents -Identity "Jacob Berger" -CancelOrganizedMeetings -QueryStartDate 9-1-2018 -QueryWindowInDays 90 -PreviewOnly -Verbose

В этом примере предварительный просмотр собраний, которые будут отменены в календаре Джейкоба Бергера для указанного диапазона дат. В почтовый ящик не вносятся никакие изменения.

Параметры

-CancelOrganizedMeetings

Параметр CancelOrganizedMeetings определяет, будет ли отменено собрание в почтовом ящике. Указывать значение для этого параметра необязательно.

Чтобы отменить собрания в почтовом ящике, необходимо использовать этот параметр.

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

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
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

Параметр Identity указывает почтовый ящик, который требуется изменить. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя
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

Параметр PreviewOnly указывает, следует ли просматривать результаты команды, если никаких собраний не было отменено. Указывать значение для этого параметра необязательно.

Этот параметр используется с параметром 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

Параметр QueryStartDate указывает дату начала для поиска собраний, которые нужно отменить.

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

Примечание. Если этот параметр не используется, используется текущая дата.

Чтобы указать дату окончания, используйте параметр QueryWindowInDays.

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

Параметр QueryWindowInDays указывает число дней после даты, указанной в параметре QueryStartDate, для поиска собраний, которые нужно отменить.

Если хотя бы один экземпляр повторяющегося собрания приходится на указанный период, отменяется весь ряд (а не только экземпляры на протяжении этого периода).

Примечание. Максимально допустимое окно для отмены собрания — 1825 дней (5 лет).

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

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

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