Get-ComputerRestorePoint

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

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

構文

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

説明

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

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

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

例

例 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-ComputerRestorePointは LastStatus パラメーターを使用して、最新のシステム復元の結果を表示します。

例 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 パラメーターを使用して表示するプロパティを指定します。 パイプライン内の各オブジェクトについて、式 in $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 クラスを使用します。