次の方法で共有

Restore-RecoverableItems

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Server 2016, Exchange Server 2019, Exchange Online

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。

Restore-RecoverableItems items コマンドレットを使用して、メールボックス内の削除済みアイテムを復元します。 Get-RecoverableItems コマンドレットを使用して、回復する削除済みアイテムを見つけます。

このコマンドレットはメールボックスインポートエクスポートロールでのみ使用でき、既定ではロールはどの役割グループにも割り当てられません。 このコマンドレットを使用するには、役割グループ (組織の管理役割グループなど) にメールボックスインポートエクスポートロールを追加する必要があります。 詳細については、「役割グループへ役割を追加する」を参照してください。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Restore-RecoverableItems
       -Identity <GeneralMailboxOrMailUserIdParameter>
       [-EntryID <String>]
       [-FilterEndTime <DateTime>]
       [-FilterItemType <String>]
       [-FilterStartTime <DateTime>]
       [-LastParentFolderID <String>]
       [-ResultSize <Unlimited>]
       [-SourceFolder <RecoverableItemsFolderType>]
       [-SubjectContains <String>]
       [<CommonParameters>]
Restore-RecoverableItems
       -Identity <GeneralMailboxOrMailUserIdParameter[]>
       [-EntryID <String>]
       [-FilterEndTime <DateTime>]
       [-FilterItemType <String>]
       [-FilterStartTime <DateTime>]
       [-LastParentFolderID <String>]
       [-MaxParallelSize <Int32>]
       [-NoOutput]
       [-PolicyTag <String[]>]
       [-RestoreTargetFolder <String>]
       [-ResultSize <Unlimited>]
       [-SourceFolder <RecoverableItemsFolderType>]
       [-SubjectContains <String>]
       [<CommonParameters>]

説明

アイテムに関する情報が使用可能な場合、アイテムは元のフォルダーの場所に復元されます。 情報が見つからない場合、アイテムはアイテムの種類 (メッセージの場合は受信トレイ、会議や予定の予定表など) の既定のフォルダーに復元されます。

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

例

例 1

Restore-RecoverableItems -Identity laura@contoso.com -FilterItemType IPM.Note -SubjectContains "FY18 Accounting" -FilterStartTime "2/1/2018 12:00:00 AM" -FilterEndTime "2/5/2018 11:59:59 PM"

Get-RecoverableItems コマンドレットを使用してアイテムの存在を確認した後、次の使用例は、指定した削除済みアイテムを指定したメールボックスから復元します。

  • メールボックス： laura@contoso.com
  • アイテムの種類: Email メッセージ
  • メッセージの件名: FY18 会計
  • 場所: 回復可能なアイテム\削除
  • 日付範囲: 2018 年 2 月 1 日から 2018 年 2 月 5 日

例 2

$mailboxes = Import-CSV "C:\My Documents\RestoreMessage.csv"

$mailboxes | foreach {Restore-RecoverableItems -Identity $_.SMTPAddress -SubjectContains "Project X" -SourceFolder DeletedItems -FilterItemType IPM.Note}

Exchange Serverでは、この例では、コンマ区切り値 (CSV) ファイル C:\My Documents\RestoreMessage.csvで指定されているメールボックスの削除された電子メール メッセージ "Project X" を復元します。 CSV ファイルは、ヘッダー値 SMTPAddress を使用し、次のように個別の行に各メールボックスのメール アドレスが含まれています。

SMTPAddress

chris@contoso.com

michelle@contoso.com

laura@contoso.com

julia@contoso.com

最初のコマンドは、csv ファイルを $mailboxes という名前の変数に読み取ります。 2 番目のコマンドは、これらのメールボックスの [削除済みアイテム] フォルダーから指定したメッセージを復元します。

例 3

Restore-RecoverableItems -Identity "malik@contoso.com","lillian@contoso.com" -FilterItemType IPM.Note -SubjectContains "COGS FY17 Review" -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM" -MaxParallelSize 2

Exchange Onlineで、Get-RecoverableItems コマンドレットを使用してアイテムの存在を確認した後、次の使用例は、指定したメールボックス内の指定した削除済みアイテムを復元します。

  • メールボックス: malik@contoso.com、 lillian@contoso.com
  • アイテムの種類: Email メッセージ
  • メッセージの件名: COGS FY17 レビュー
  • 場所: 回復可能なアイテム\削除
  • 日付範囲: 2019 年 3 月 15 日から 2019 年 3 月 25 日
  • 同時に処理されるメールボックスの数: 2

例 4

Get-RecoverableItems administrator | Restore-RecoverableItems

この例では、管理者が回復可能なすべての項目を一括復元します。

パラメーター

-EntryID

EntryID パラメーターは、復元する削除済みアイテムを指定します。 削除済みアイテムの EntryID は、メールボックスにおいて一意の値です。

Get-RecoverableItems コマンドレットの他の検索フィルター (件名、日付範囲など) を使用して、特定の項目の EntryID を見つけることができます。

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

-FilterEndTime

FilterEndTime は、日付範囲の終了日時を指定します。 このパラメーターは、アイテムの LastModifiedTime 値を使用します。

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

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

-FilterItemType

FilterItemType パラメーターは、削除されたアイテムの指定された MessageClass (ItemClass) プロパティ値によって結果をフィルター処理します。 例:

  • IPM.Appointment (会議と予定)
  • Ipm。連絡先
  • Ipm。ファイル
  • IPM.Note
  • Ipm。タスク
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-FilterStartTime

FilterStartTime は、日付範囲の開始日/時刻を指定します。 このパラメーターは、アイテムの LastModifiedTime 値を使用します。

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

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

-Identity

Identity パラメーターは、復元する削除済みアイテムを含むメールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。

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

Exchange Onlineでは、複数のメールボックスをコンマで区切って指定できます。 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"

Type:GeneralMailboxOrMailUserIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-LastParentFolderID

LastParentFolderID パラメーターは、アイテムが削除される前の FolderID 値を指定します。 例: 53B93149989CA54DBC9702AE619B9CCA000062CE9397。

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

-MaxParallelSize

このパラメーターは、クラウドベースのサービスでのみ使用できます。

MaxParallelSize パラメーターは、コマンドによって並行して処理されるメールボックスの最大数を指定します。 有効な値は、1 ~ 10 の整数です。 通常、値を大きくすると、複数のメールボックスでコマンドを完了するのにかかる時間が短縮されます。

Identity パラメーターでメールボックスが 1 つだけ指定されている場合、このパラメーターの値は影響しません。

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

-NoOutput

このパラメーターは、クラウドベースのサービスでのみ使用できます。

NoOutput スイッチは、削除された項目をコンソールにコマンド出力なしで直接復元します。 このスイッチで値を指定する必要はありません。

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

-PolicyTag

このパラメーターは、クラウドベースのサービスでのみ使用できます。

{{ Fill PolicyTag Description }}

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RestoreTargetFolder

このパラメーターは、クラウドベースのサービスでのみ使用できます。

RestoreTargetFolder パラメーターは、データを復元する最上位フォルダーを指定します。 このパラメーターを指定しない場合、復元先のメールボックスまたはアーカイブのフォルダー構造の最上位に、フォルダーが復元されます。 コンテンツは既存のフォルダーの下で結合され、フォルダーが復元先のフォルダー構造内に存在していない場合は新しいフォルダーが作成されます。

このパラメーターはアーカイブに必要で、プライマリ メールボックスの場合は省略可能です。 コピー先フォルダーが存在しない場合は作成されます。 有効なパスは次のとおりです。

  • /
  • /folder1
  • /folder1/folder2
  • folder1
  • folder1/folder2

前または末尾 / は無視されます。 次に、IPM サブツリーの相対パスとして扱われます。 /Top Of Information Store

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。

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

-SourceFolder

SourceFolder パラメーターは、メールボックス内の削除済みアイテムを検索する場所を指定します。 有効な値は次のとおりです。

  • DeletedItems:削除済みアイテム フォルダー。
  • RecoverableItems: 回復可能なアイテム\削除フォルダー。 このフォルダーには、削除済みアイテム フォルダー (論理的に削除されたアイテム) から削除されたアイテムが含まれています。
  • PurgeedItems: 回復可能なアイテム\Purges フォルダー。 このフォルダーには、回復可能なアイテム フォルダー (ハード削除されたアイテム) から削除されたアイテムが含まれています。

このパラメーターを使用しない場合、コマンドはこれら 3 つのフォルダーを検索します。

  • DiscoveryHoldsItems: 回復可能なアイテム\DiscoveryHolds フォルダー。 このフォルダーには、回復可能なアイテム フォルダー (ハード削除されたアイテム) から削除され、保留で保護されているアイテムが含まれています。 このフォルダー内の削除済みアイテムを検索するには、値 DiscoveryHoldsItems でこのパラメーターを使用します。
Type:RecoverableItemsFolderType
Accepted values:DeletedItems | RecoverableItems | PurgedItems
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SubjectContains

SubjectContains パラメーターは、Subject フィールドの指定されたテキスト値によって削除されたアイテムをフィルター処理します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

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