Undo-Transaction

構文

Undo-Transaction
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Undo-Transaction コマンドレットは、アクティブなトランザクションをロールバックします。 トランザクションをロールバックすると、トランザクション内のコマンドによって行われた変更は破棄され、データは元の形式に復元されます。

トランザクションに複数のサブスクライバーが含まれている場合、 Undo-Transaction コマンドはすべてのサブスクライバーのトランザクション全体をロールバックします。

既定では、トランザクション内のいずれかのコマンドでエラーが発生すると、トランザクションは自動的にロールバックされます。 ただし、トランザクションは別のロールバック設定を使用して開始できます。このコマンドレットを使用すると、アクティブなトランザクションをいつでもロールバックできます。

Undo-Transaction コマンドレットは、Windows PowerShell のトランザクション機能をサポートする一連のコマンドレットの 1 つです。 詳細については、「 about_Transactions」を参照してください。

例

例 1: 現在のトランザクションをロールバックする

Undo-Transaction

このコマンドは、現在アクティブなトランザクションをロールバックします。

例 2: トランザクションを開始してロールバックする

Set-Location hkcu:\software
Start-Transaction
New-Item -Path "ContosoCompany" -UseTransaction
Undo-Transaction

この例では、トランザクションを開始し、ロールバックします。 その結果、レジストリは変更されません。

例 3: すべてのサブスクライバーのトランザクションをロールバックする

Set-Location hkcu:\software
Start-Transaction
New-Item -Path "ContosoCompany" -UseTransaction
Get-Transaction

RollbackPreference   SubscriberCount   Status
------------------   ---------------   -----
Error                1                 Active

Start-Transaction
Get-Transaction

RollbackPreference   SubscriberCount   Status
------------------   ---------------   -----
Error                2                 Active

Undo-Transaction
Get-Transaction

RollbackPreference   SubscriberCount   Status
------------------   ---------------   -----
Error                0                 RolledBack

この例では、サブスクライバーがトランザクションをロールバックすると、すべてのサブスクライバーに対してトランザクション全体がロールバックされることを示します。

最初のコマンドは、場所を HKCU:\Software レジストリ キーに変更します。

2 番目のコマンドは、トランザクションを開始します。

3 番目のコマンドでは、 New-Item コマンドレットを使用して新しいレジストリ キーを作成します。 このコマンドでは、 UseTransaction パラメーターを使用して、トランザクションに変更を含めます。

4 番目のコマンドでは、 Get-Transaction コマンドレットを使用してアクティブなトランザクションを取得します。 ステータスが Active であり、サブスクライバーの数が 1 であることに注意してください。

5 番目のコマンドでは、 Start-Transaction コマンドをもう一度使用します。 通常、別のトランザクションの進行中にトランザクションを開始することは、メイン トランザクションで使用されるスクリプトに独自の完全なトランザクションが含まれている場合に発生します。 この例は、段階的に確認できるように対話形式で実行されます。 別のトランザクションの進行中に Start-Transaction コマンドを実行すると、コマンドは既存のトランザクションを新しいサブスクライバーとして結合し、サブスクライバー数が増加します。

6 番目のコマンドでは、 Get-Transaction コマンドレットを使用してアクティブなトランザクションを取得します。 サブスクライバーの数が 2 になったことに注意してください。

7 番目のコマンドでは、 Undo-Transaction を使用してトランザクションをロールバックします。 このコマンドはオブジェクトを返しません。

最後のコマンドは、アクティブなトランザクション (この場合は、最後にアクティブなトランザクション) を取得する Get-Transaction コマンドです。 トランザクションがロールバックされたことと、サブスクライバーの数が 0 になったことが結果に示されます。つまり、トランザクションがすべてのサブスクライバーに対してロールバックされました。

パラメーター

-Confirm

-WhatIf

入力

None

パイプを使用してこのコマンドレットに入力を渡すことはできません。

出力

None

このコマンドレットによる戻り値はありません。

メモ

• コミット済みのトランザクションはロールバックできません。

  有効でないトランザクションはロールバックできません。 独立した別のトランザクションをロールバックするには、有効なトランザクションを先にコミットするかロールバックする必要があります。

  トランザクションをロールバックすると、そのトランザクションは終了します。 トランザクションを再度使用するには、トランザクションを新たに開始する必要があります。

関連リンク

• Complete-Transaction
• Get-Transaction
• Start-Transaction
• Use-Transaction