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>]

説明

このコマンドレットは、メールボックスが会議の開催者のもので、会議の出席者が 1 人以上いるかまたはリソースが 1 つ以上ある指定のメールボックスの中にある会議をキャンセルします。 出席者がいない、またはリソースがない場合は、予定や会議をキャンセルすることはできません。 会議の取り消しは送信する必要があるため、メールボックスは引き続きメールの送信を有効にする必要があります。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

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

次の使用例は、今日の日付から 120 日後に発生するメールボックス chris@contoso.com 内のすべての会議を取り消します。 会議をキャンセルした後、メールボックスを削除できます。

例 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

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 パラメーターは、変更するメールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • Domain\Username
  • 電子メール アドレス
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ユーザー ID またはユーザー プリンシパル名 (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

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 パラメーターは、キャンセルする会議を見つけるために、検索の開始日を指定します。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 mm/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "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