Remove-CalendarEvents

Referencia

Módulo:: ExchangePowerShell

Se aplica a:: Exchange Server 2019, Exchange Online

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Use el cmdlet Remove-CalendarEvents para cancelar futuras reuniones en buzones de usuario o de recursos. La cancelación de futuras reuniones los quita de los calendarios de asistentes y recursos (por ejemplo, va a quitar el buzón o el usuario va a dejar de hacerlo).

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

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

Description

Este cmdlet cancela las reuniones en el buzón especificado donde el buzón es el organizador de la reunión y la reunión tiene uno o varios asistentes o recursos. No cancela citas ni reuniones sin asistentes ni recursos. Dado que se deben enviar cancelaciones de reuniones, el buzón debe estar habilitado para enviar correo.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

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

En este ejemplo se cancelan todas las reuniones del buzón de correo chris@contoso.com que se producen en o 120 días después de la fecha de hoy. Después de cancelar las reuniones, puede quitar el buzón.

Ejemplo 2

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

En este ejemplo se cancelan las reuniones del calendario de Angela Gruber para el intervalo de fechas especificado. Angela está tomando un permiso temporal de ausencia de la empresa, por lo que cancelar estas reuniones las quita del calendario de usuarios y recursos durante su ausencia.

Ejemplo 3

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

En este ejemplo se obtiene una vista previa de las reuniones que se cancelarían en el calendario de Jacob Berger para el intervalo de fechas especificado. No se realizan cambios en el buzón.

Parámetros

-CancelOrganizedMeetings

El modificador CancelOrganizedMeetings especifica si se van a cancelar reuniones en el buzón. No es necesario especificar un valor con este modificador.

Para cancelar reuniones en el buzón de correo, debe usar este modificador.

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

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el 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

El parámetro Identity especifica el buzón que desea modificar. Es posible usar cualquier valor que identifique exclusivamente el buzón. Por ejemplo:

Nombre
Alias
Nombre distintivo (DN)
Nombre completo (DN)
Dominio\Nombre de usuario
Dirección de correo electrónico
GUID
LegacyExchangeDN
SamAccountName
ID de usuario o nombre de la entidad de seguridad de usuario (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

El modificador PreviewOnly especifica si se van a obtener una vista previa de los resultados del comando sin cancelar realmente ninguna reunión. No es necesario especificar un valor con este modificador.

Use este modificador con el modificador 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

El parámetro QueryStartDate especifica la fecha de inicio para buscar las reuniones que desea cancelar.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".

Nota: Si no usa este parámetro, se usa la fecha de hoy.

Use el parámetro QueryWindowInDays para especificar la fecha de finalización.

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

El parámetro QueryWindowInDays especifica el número de días después del valor del parámetro QueryStartDate para buscar las reuniones que desea cancelar.

Si se produce una instancia de una reunión periódica durante el período de tiempo especificado, se cancela toda la serie (no solo las instancias durante el período de tiempo).

Nota: La ventana máxima permitida para la cancelación de reuniones es de 1825 días (5 años).

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

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

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