Remove-CalendarEvents

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Server 2019, Exchange Online

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Usare il cmdlet Remove-CalendarEvents per annullare le riunioni future nelle cassette postali degli utenti o delle risorse. Annullando le riunioni future, queste vengono rimosse dai calendari dei partecipanti e delle risorse (ad esempio, viene rimossa la cassetta postale o l'utente sta andando in congedo).

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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

Descrizione

Questo cmdlet annulla le riunioni nella cassetta postale specificata in cui la cassetta postale è l'organizzatore della riunione e la riunione ha uno o più partecipanti o risorse. Non vengono annullati appuntamenti o riunioni senza partecipanti o risorse. Poiché gli annullamenti delle riunioni devono essere inviati, la cassetta postale deve comunque essere abilitata per l'invio di posta elettronica.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

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

Questo esempio annulla ogni riunione nella cassetta postale chris@contoso.com che si verifica in o 120 giorni dopo la data odierna. Dopo avere annullato le riunioni, è possibile rimuovere la cassetta postale.

Esempio 2

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

Questo esempio annulla le riunioni nel calendario di Angela Gruber per l'intervallo di date specificato. Angela sta per andare in congedo, in questo modo annullando le riunioni, queste vengono rimosse dai calendari dell'utente e delle risorse durante la sua assenza.

Esempio 3

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

In questo esempio vengono visualizzate in anteprima le riunioni che verranno annullate nel calendario di Jacob Berger per l'intervallo di date specificato. Non vengono apportate modifiche alla cassetta postale.

Parametri

-CancelOrganizedMeetings

L'opzione CancelOrganizedMeetings consente di specificare se annullare le riunioni nella cassetta postale. Con questa opzione non è necessario specificare alcun valore.

Per annullare le riunioni nella cassetta postale, è necessario utilizzare questa opzione.

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

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
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

Il parametro Identity indica la cassetta postale che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Dominio\nomeutente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (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

L'opzione PreviewOnly consente di specificare se si desidera visualizzare in anteprima i risultati del comando senza effettivamente annullare le riunioni. Con questa opzione non è necessario specificare alcun valore.

Utilizzare questa opzione con l'opzione 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

Il parametro QueryStartDate consente di specificare la data di inizio da cui iniziare a cercare le riunioni da annullare.

Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Ad esempio, se il computer è configurato per l'utilizzo del formato di data breve mm/dd/yyyy, immettere 01/09/2018 per specificare il 1° settembre 2018. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".

Nota: se non si usa questo parametro, viene usata la data odierna.

Utilizzare il parametro QueryWindowInDays per specificare la data di fine.

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

Il parametro QueryWindowInDays consente di specificare il numero di giorni dopo il valore del parametro QueryStartDate in cui cercare le riunioni da annullare.

Se si verifica un'istanza di una riunione ricorrente durante il periodo di tempo specificato, viene annullata l'intera serie (non solo le istanze durante il periodo di tempo).

Nota: la finestra massima consentita per l'annullamento della riunione è di 1825 giorni (5 anni).

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

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

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