Restore-RecoverableItems

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターと設定は、1 つの環境または別の環境に限定される場合があります。

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

このコマンドレットは、Mailbox Import Export 役割でのみ使用でき、既定では、この役割はどの役割グループにも割り当てられていません。 このコマンドレットを使用するには、Mailbox Import Export 役割を役割グループ (たとえば、Organization Management 役割グループ) に追加する必要があります。 詳細については、「役割グループへ役割を追加する」を参照してください。

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

構文

OnPremises

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

Cloud

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

説明

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

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 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 message
  • メッセージの件名: 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 message
  • メッセージの件名: COGS FY17 レビュー
  • 場所: 回復可能な項目\削除
  • 日付の範囲: 2019/3/15 から 2019/3/25
  • 同時に処理されるメールボックスの数: 2

例 4

Get-RecoverableItems administrator | Restore-RecoverableItems

この例では、管理者の回復可能なすべてのアイテムを一括で復元します。

パラメーター

-EntryID

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-FilterEndTime

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

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

パラメーターのプロパティ

型:DateTime
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-FilterItemType

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

  • IPM.Appointment (会議と予定)
  • IPM.連絡先
  • IPM.ファイル
  • IPM.Note
  • IPM.タスク

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-FilterStartTime

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

FilterStartTime は、日付範囲の開始日時を指定します。 このパラメーターは、項目の LastModifiedTime 値を使用します。

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

パラメーターのプロパティ

型:DateTime
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Identity

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

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

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

パラメーターのプロパティ

型:GeneralMailboxOrMailUserIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

OnPremises
配置:1
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
Cloud
配置:1
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-LastParentFolderID

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MaxParallelSize

適用対象: Exchange Online

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

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

Identity パラメーターでメールボックスが 1 つだけを指定している場合、このパラメーターの値は効果がありません。

パラメーターのプロパティ

型:Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Cloud
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-NoOutput

適用対象: Exchange Online

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

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Cloud
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PolicyTag

適用対象: Exchange Online

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

{{ Fill PolicyTag description }}

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Default
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RestoreTargetFolder

適用対象: Exchange Online

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

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

このパラメーターはプライマリ メールボックスでのみ使用可能で、アーカイブ メールボックスでは無視されます。 存在しない場合は、宛先フォルダーが作成されます。 有効なパスは次のとおりです。

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

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Default
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ResultSize

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

パラメーターのプロパティ

型:Unlimited
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SourceFolder

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

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

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

  • DiscoveryHoldsItems (クラウドのみ): 回復可能なアイテム\DiscoveryHolds フォルダー。 このフォルダーには、[回復可能なアイテム] フォルダーから消去されたアイテム (物理的に削除されたアイテム) が含まれており、保留によって保護されています。 このフォルダー内の削除済みアイテムを検索するには、このパラメーターを値 DiscoveryHoldsItems とともに使用します。

パラメーターのプロパティ

型:RecoverableItemsFolderType
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

OnPrem
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SubjectContains

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。