Get-RecoverableItems
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターと設定は、1 つの環境または別の環境に限定される場合があります。
Get-RecoverableItems アイテム コマンドレットを使用して、メールボックス内の削除済みアイテムを表示します。 削除済みアイテムを見つけたら、Restore-RecoverableItems コマンドレットを使用してそれらを復元します。
このコマンドレットは、Mailbox Import Export 役割でのみ使用でき、既定では、この役割はどの役割グループにも割り当てられていません。 このコマンドレットを使用するには、Mailbox Import Export 役割を役割グループ (たとえば、Organization Management 役割グループ) に追加する必要があります。 詳細については、「役割グループへ役割を追加する」を参照してください。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
OnPremises
Get-RecoverableItems
-Identity <GeneralMailboxOrMailUserIdParameter>
[-EntryID <String>]
[-FilterEndTime <DateTime>]
[-FilterItemType <String>]
[-FilterStartTime <DateTime>]
[-LastParentFolderID <String>]
[-ResultSize <Unlimited>]
[-SourceFolder <RecoverableItemsFolderType>]
[-SubjectContains <String>]
[<CommonParameters>]
Cloud
Get-RecoverableItems
-Identity <GeneralMailboxOrMailUserIdParameter[]>
[-EntryID <String>]
[-FilterEndTime <DateTime>]
[-FilterItemType <String>]
[-FilterStartTime <DateTime>]
[-LastParentFolderID <String>]
[-MaxParallelSize <Int32>]
[-PolicyTag <String[]>]
[-ResultSize <Unlimited>]
[-SkipCount <Int32>]
[-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.com と lillian@contoso.com の両方のメールボックスに、使用可能な回復可能な削除済みメッセージを、件名とともにすべて返します。
パラメーター
-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"。
注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | 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 |
-PolicyTag
適用対象: Exchange Online
このパラメーターは、クラウドベースのサービスでのみ使用できます。
{{ Fill PolicyTag description }}
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Cloud
| 配置: | 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 |
-SkipCount
適用対象: Exchange Online
このパラメーターは、クラウドベースのサービスでのみ使用できます。
{{ Fill SkipCount description }}
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | 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 |
パラメーター セット
(All)
| 配置: | 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」を参照してください。