Get-RecoverableItems

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

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

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

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

構文

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

説明

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

例 1

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

次の使用例は、指定した日付/時刻範囲のメールボックス laura@contoso.com で指定された件名を持つ使用可能な回復可能な削除済みメッセージをすべて返します。

例 2

Get-RecoverableItems -Identity "malik@contoso.com", "lillian@contoso.com" -FilterItemType IPM.Note -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM"

次の使用例は、指定した日付/時刻範囲のメールボックスmalik@contoso.comlillian@contoso.comで指定された件名を持つ、回復可能なすべての削除済みメッセージを返します。

パラメーター

-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

-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

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

-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