次の方法で共有

Get-ComputerRestorePoint

  • リファレンス
モジュール:
Microsoft.PowerShell.Management

ローカル コンピューターで復元ポイントを取得します。

構文

Get-ComputerRestorePoint
   [[-RestorePoint] <Int32[]>]
   [<CommonParameters>]
Get-ComputerRestorePoint
   -LastStatus
   [<CommonParameters>]

説明

コマンドレットは Get-ComputerRestorePoint 、ローカル コンピューターのシステム復元ポイントを取得します。 また、コンピューターを復元する最新の試行の状態を表示できます。

の情報 Get-ComputerRestorePoint を使用して、復元ポイントを選択できます。 たとえば、シーケンス番号を使用して、 コマンドレットの復元ポイントを Restore-Computer 識別します。

システム復元ポイントとGet-ComputerRestorePointコマンドレットは、Windows 10、Windows 7、Windows Vista、Windows XP などのクライアント オペレーティング システムでのみサポートされます。

例

例 1: すべてのシステム復元ポイントを取得する

この例では、 は、 Get-ComputerRestorePoint ローカル コンピューターのすべてのシステム復元ポイントを取得します。

Get-ComputerRestorePoint

CreationTime           Description                    SequenceNumber    EventType         RestorePointType
------------           -----------                    --------------    ---------         ----------------
7/30/2019 09:17:24     Windows Update                 4                 BEGIN_SYSTEM_C... 17
8/5/2019  08:15:37     Installed PowerShell 7-prev... 5                 BEGIN_SYSTEM_C... APPLICATION_INSTALL
8/7/2019  12:56:45     Installed PowerShell 6-x64     6                 BEGIN_SYSTEM_C... APPLICATION_INSTALL

例 2: 特定のシーケンス番号を取得する

この例では、特定のシーケンス番号のシステム復元ポイントを取得します。

Get-ComputerRestorePoint -RestorePoint 4, 5

CreationTime           Description                    SequenceNumber    EventType         RestorePointType
------------           -----------                    --------------    ---------         ----------------
7/30/2019 09:17:24     Windows Update                 4                 BEGIN_SYSTEM_C... 17
8/5/2019  08:15:37     Installed PowerShell 7-prev... 5                 BEGIN_SYSTEM_C... APPLICATION_INSTALL

Get-ComputerRestorePointは RestorePoint パラメーターを使用して、シーケンス番号のコンマ区切りの配列を指定します。

例 3: システムの復元の状態を表示する

次の使用例は、ローカル コンピューターでの最新のシステム復元の状態を表示します。

Get-ComputerRestorePoint -LastStatus

The last attempt to restore the computer failed.

Get-ComputerRestorePointLastStatus パラメーターを使用して、最新のシステム復元の結果を表示します。

例 4: 式を使用して CreationTime を変換する

Get-ComputerRestorePoint は、 CreationTime を Windows Management Instrumentation (WMI) の日付と時刻の文字列として出力します。

この例では、変数は CreationTime 文字列を DateTime オブジェクトに変換する式を格納します。 変換前に CreationTime 文字列を表示するには、 などの ((Get-ComputerRestorePoint).CreationTime)コマンドを使用します。 WMI の日付と時刻の文字列の詳細については、「 CIM_DATETIME」を参照してください。

$date = @{Label="Date"; Expression={$_.ConvertToDateTime($_.CreationTime)}}
Get-ComputerRestorePoint | Select-Object -Property SequenceNumber, $date, Description

SequenceNumber   Date                 Description
--------------   ----                 -----------
             4   7/30/2019 09:17:24   Windows Update
             5   8/5/2019  08:15:37   Installed PowerShell 7-preview-x64
             6   8/7/2019  12:56:45   Installed PowerShell 6-x64

変数には $date 、 ConvertToDateTime メソッドを使用する式を含むハッシュ テーブルが格納されます。 式は、 CreationTime プロパティの値を WMI 文字列から DateTime オブジェクトに変換します。

Get-ComputerRestorePoint は、システム復元ポイント オブジェクトをパイプラインの下に送信します。 Select-Objectは Property パラメーターを使用して、表示するプロパティを指定します。 パイプライン内のオブジェクトごとに、 の $date 式によって CreationTime が変換され、 Date プロパティに結果が出力されます。

例 5: プロパティを使用してシーケンス番号を取得する

次の使用例は、 SequenceNumber プロパティと配列インデックスを使用してシーケンス番号を取得します。 出力にはシーケンス番号のみが含まれます。

((Get-ComputerRestorePoint).SequenceNumber)[-1]

6

Get-ComputerRestorePoint では、 SequenceNumber プロパティを配列インデックスと共に使用します。 の -1 配列インデックスは、配列内の最新のシーケンス番号を取得します。

パラメーター

-LastStatus

最新のシステム復元操作の状態を取得することを Get-ComputerRestorePoint 示します。

Type:SwitchParameter
Position:Named
Default value:False
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RestorePoint

システム復元ポイントのシーケンス番号を指定します。 1 つのシーケンス番号またはシーケンス番号のコンマ区切りの配列を指定できます。

RestorePoint パラメーターが指定されていない場合は、Get-ComputerRestorePointすべてのローカル コンピューターのシステム復元ポイントを返します。

Type:Int32[]
Position:0
Default value:All restore points
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

None

パイプライン Get-ComputerRestorePointの下にオブジェクトを送信することはできません。

出力

ManagementObject

Get-ComputerRestorePoint は、Windows Management Instrumentation (WMI) SystemRestore クラスのインスタンスである SystemRestore オブジェクトを 返します。

LastStatus パラメーターを使用すると、Get-ComputerRestorePoint文字列が返されます。

メモ

Windows Vista 以降のバージョンの Windows でコマンドを Get-ComputerRestorePoint 実行するには、[ 管理者として実行 ] オプションを使用して PowerShell を開きます。

Get-ComputerRestorePoint は WMI SystemRestore クラスを 使用します。