次の方法で共有

Start-Transaction

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

トランザクションを開始します。

構文

Start-Transaction
     [-Timeout <Int32>]
     [-Independent]
     [-RollbackPreference <RollbackSeverity>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

Start-Transaction コマンドレットは、トランザクションを開始します。トランザクションは、ユニットとして管理される一連のコマンドです。 トランザクションは完了することも、コミットすることもできます。 または、トランザクションによって変更されたデータが元の状態に復元されるように、完全に元に戻すかロールバックすることもできます。 トランザクション内のコマンドは 1 つの単位として管理されるため、すべてのコマンドがコミットされるか、すべてのコマンドがロールバックされます。

既定では、トランザクション内のコマンドでエラーが生成された場合、トランザクションは自動的にロールバックされます。 この動作を変更するには、RollbackPreference パラメーターを使用できます。

トランザクションで使用されるコマンドレットは、トランザクションをサポートするように設計されている必要があります。 トランザクションをサポートするコマンドレットには、UseTransaction パラメーターがあります。 プロバイダーでトランザクションを実行するには、プロバイダーがトランザクションをサポートする必要があります。 Windows Vista 以降のバージョンの Windows オペレーティング システムの Windows PowerShell レジストリ プロバイダーは、トランザクションをサポートしています。 Microsoft.PowerShell.Commands.Management.TransactedString クラスを使用して、Windows PowerShell をサポートする任意のバージョンの Windows システム上のトランザクションに式を含めることもできます。 他の Windows PowerShell プロバイダーもトランザクションをサポートできます。

一度にアクティブにできるトランザクションは 1 つだけです。 トランザクションの進行中に新しい独立したトランザクションを開始すると、新しいトランザクションがアクティブなトランザクションになります。元のトランザクションに変更を加える前に、新しいトランザクションをコミットまたはロールバックする必要があります。

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

例

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

Set-Location HKCU:\software
Start-Transaction
New-Item "ContosoCompany" -UseTransaction
New-ItemProperty "ContosoCompany" -Name "MyKey" -Value 123 -UseTransaction
Undo-Transaction

これらのコマンドは、トランザクションを開始してからロールバックします。 トランザクションはロールバックされるため、レジストリに変更は加えわれません。

例 2: トランザクションを開始して完了する

Set-Location HKCU:\software
Start-Transaction
New-Item "ContosoCompany" -UseTransaction
New-ItemProperty "ContosoCompany" -Name "MyKey" -Value 123 -UseTransaction
Complete-Transaction

これらのコマンドは、トランザクションを開始してから完了します。 Complete-Transaction コマンドが使用されるまで、レジストリに対する変更は行われません。

例 3: さまざまなロールバック設定を使用する

Set-Location HKCU:\software
Start-Transaction
New-Item -Path "NoPath" -Name "ContosoCompany" -UseTransaction
New-Item -Path . -Name "ContosoCompany" -UseTransaction
Start-Transaction -RollbackPreference Never
New-Item -Path "NoPath" -Name "ContosoCompany" -UseTransaction
New-Item -Path . -Name "ContosoCompany" -UseTransaction

# Start-Transaction (-RollbackPreference Error)

Start-Transaction
New-Item -Path "NoPath" -Name "ContosoCompany" -UseTransaction
New-Item : The registry key at the specified path does not exist.

At line:1 char:9
+ New-Item <<<<  -Path NoPath -Name ContosoCompany -UseTransaction

New-Item -Path . -Name "Contoso" -UseTransaction

New-Item : Cannot use transaction. The transaction has been rolled back or has timed out.
At line:1 char:9
+ New-Item <<<<  -Path . -Name ContosoCompany -UseTransaction

# Start-Transaction (-RollbackPreference Never)

Start-Transaction -RollbackPreference Never
New-Item -Path "NoPath" -Name "ContosoCompany" -UseTransaction

New-Item : The registry key at the specified path does not exist.
At line:1 char:9
+ New-Item <<<<  -Path NoPath -Name "ContosoCompany" -UseTransaction

New-Item -Path . -Name "ContosoCompany" -UseTransaction

Hive: HKEY_CURRENT_USER\Software
SKC  VC Name                           Property
---  -- ----                           --------
0   0 ContosoCompany                 {}
Complete-Transaction

# Succeeds

この例では、RollbackPreference パラメーター値を変更した場合の影響を示します。

コマンドの最初のセットでは、Start-Transaction は RollbackPreference 使用しません。 その結果、既定値 (Error) が使用されます。 トランザクション コマンドでエラーが発生した場合、つまり、指定したパスが存在しない場合、トランザクションは自動的にロールバックされます。

2 番目のコマンド セットでは、Start-Transaction は値が Never RollbackPreference を使用します。 その結果、トランザクション コマンドでエラーが発生しても、トランザクションは引き続きアクティブであり、正常に完了できます。

ほとんどのトランザクションはエラーなしで実行する必要があるため、通常、RollbackPreference の既定値 使用することをお勧めします。

例 4: トランザクションの進行中にこのコマンドレットを使用する

Set-Location HKCU:\software
Start-Transaction
New-Item "ContosoCompany" -UseTransaction
Start-Transaction
Get-Transaction
New-Item "ContosoCompany2" -UseTransaction
Complete-Transaction
Complete-Transaction
Get-Transaction

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

この例では、トランザクションの進行中に Start-Transaction を使用した場合の効果を示します。 効果は、進行中のトランザクションに参加するのとよく似ています。

これは簡略化されたコマンドですが、このシナリオは、トランザクションが完全なトランザクションを含むスクリプトの実行を伴う場合に頻繁に発生します。

最初の Start-Transaction コマンドは、トランザクションを開始します。 最初の New-Item コマンドはトランザクションの一部です。

2 番目の Start-Transaction コマンドは、トランザクションに新しいサブスクライバーを追加します。 Get-Transaction コマンドは、サブスクライバー数が 2 のトランザクションを返すようになりました。 2 番目の New-Item コマンドは、同じトランザクションの一部です。

トランザクション全体が完了するまで、レジストリに対する変更は行われません。 トランザクションを完了するには、サブスクライバーごとに 1 つずつ、2 つの Complete-Transaction コマンドを入力する必要があります。 任意の時点でトランザクションをロールバックすると、両方のサブスクライバーのすべてのトランザクションがロールバックされます。

例 5: 実行中に独立したトランザクションを開始する

Set-Location HKCU:\software
Start-Transaction
New-Item "ContosoCompany" -UseTransaction
Start-Transaction -Independent
Get-Transaction
Undo-Transaction
New-ItemProperty -Path "ContosoCompany" -Name "MyKey" -Value 123 -UseTransaction
Complete-Transaction
Get-ChildItem contoso*
Get-Transaction

RollbackPreference   SubscriberCount   Status
------------------   ---------------   ------
Error                1                 Active
Undo-Transaction
New-ItemProperty -Path "ContosoCompany" -Name "MyKey" -Value 123 -UseTransaction
MyKey
-----
123
Complete-Transaction
Get-ChildItem contoso*
Hive: HKEY_CURRENT_USER\Software
SKC  VC Name                           Property
---  -- ----                           --------
0   1 MyCompany                      {MyKey}

この例では、 の Start-Transaction パラメーターを使用して、別のトランザクションの進行中にトランザクションを開始する効果を示します。 この場合、新しいトランザクションは元のトランザクションに影響を与えずにロールバックされます。

トランザクションは論理的に独立していますが、一度にアクティブにできるトランザクションは 1 つだけであるため、元のトランザクションで作業を再開する前に、最新のトランザクションをロールバックまたはコミットする必要があります。

コマンドの最初のセットは、トランザクションを開始します。 New-Item コマンドは、最初のトランザクションの一部です。

2 番目のコマンド セットでは、Start-Transaction コマンドは Independent パラメーターを使用します。 次の Get-Transaction コマンドは、アクティブなトランザクションのトランザクション オブジェクトを示しています。これは最新のトランザクションです。 サブスクライバー数は 1 に等しく、トランザクションが無関係であることを示します。

Undo-Transaction コマンドを使用してアクティブなトランザクションがロールバックされると、元のトランザクションが再びアクティブになります。

元のトランザクションの一部である New-ItemProperty コマンドはエラーなしで終了し、Complete-Transaction コマンドを使用して元のトランザクションを完了できます。 その結果、レジストリが変更されます。

例 6: トランザクションに含まれていないコマンドを実行する

Set-Location HKCU:\software
Start-Transaction
New-Item "ContosoCompany1" -UseTransaction
New-Item "ContosoCompany2"
New-Item "ContosoCompany3" -UseTransaction
Get-ChildItem contoso*

Hive: HKEY_CURRENT_USER\Software
SKC  VC Name                           Property
---  -- ----                           --------
0   0 ContosoCompany2                {}

Complete-Transaction
Get-ChildItem contoso*

Hive: HKEY_CURRENT_USER\Software
SKC  VC Name                           Property
---  -- ----                           --------
0   0 ContosoCompany1                     {}
0   0 ContosoCompany2                     {}
0   0 ContosoCompany3                     {}

この例では、トランザクションの進行中に送信されたコマンドをトランザクションに含めることができるか、含めないことを示します。 UseTransaction パラメーターを使用するコマンドのみがトランザクションの一部です。

1 番目と 3 番目の New-Item コマンドでは、UseTransaction パラメーターを使用します。 これらのコマンドは、トランザクションの一部です。 2 番目の New-Item コマンドは、UseTransaction パラメーターを使用しないため、トランザクションの一部ではありません。

最初の Get-ChildItem コマンドは効果を示します。 2 番目の New-Item コマンドはすぐに完了しますが、トランザクションがコミットされるまで、1 番目と 3 番目の New-Item コマンドは有効ではありません。

Complete-Transaction コマンドはトランザクションをコミットします。 その結果、2 番目の Get-ChildItem コマンドは、すべての新しい項目がレジストリに追加されることを示します。

例 7: 指定した時間内に完了しないトランザクションをロールバックする

Start-Transaction -Timeout 2

# Wait two minutes...

Get-Transaction
New-Item HKCU:\Software\ContosoCompany -UseTransaction
Start-Transaction -Timeout 2

# Wait two minutes...

Get-Transaction

RollbackPreference   SubscriberCount   Status
------------------   ---------------   -----------
Error                1                 RolledBack

New-Item HKCU:\Software\ContosoCompany -UseTransaction

New-Item : Cannot use transaction. The transaction has been rolled back or has timed out.
At line:1 char:9
+ New-Item <<<<  MyCompany -UseTransaction

このコマンドは、 の Start-Transaction パラメーターを使用して、2 分以内に完了する必要があるトランザクションを開始します。 タイムアウトが切れたときにトランザクションが完了しない場合、トランザクションは自動的にロールバックされます。

タイムアウトの有効期限が切れると通知されませんが、トランザクション オブジェクトの Status プロパティが RolledBack に設定され、UseTransaction パラメーターを使用するコマンドは失敗します。

パラメーター

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Independent

このコマンドレットは、進行中のトランザクションに依存しないトランザクションを開始することを示します。 既定では、別のトランザクションの進行中に Start-Transaction を使用すると、進行中のトランザクションに新しいサブスクライバーが追加されます。 このパラメーターは、セッションでトランザクションが既に進行中の場合にのみ有効です。

既定では、トランザクションの進行中に Start-Transaction を使用すると、既存のトランザクション オブジェクトが再利用され、サブスクライバー数がインクリメントされます。 この効果は、元のトランザクションに参加するのとよく似ています。 Undo-Transaction コマンドは、トランザクション全体をロールバックします。 トランザクションを完了するには、サブスクライバーごとに Complete-Transaction コマンドを入力する必要があります。 同時に進行中のほとんどのトランザクションは関連しているため、ほとんどの場合、既定値で十分です。

Independent パラメーターを指定した場合、このコマンドレットは、元のトランザクションに影響を与えずに完了または元に戻すことができる新しいトランザクションを作成します。 ただし、一度にアクティブにできるトランザクションは 1 つだけであるため、元のトランザクションで作業を再開する前に、新しいトランザクションを完了またはロールバックする必要があります。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RollbackPreference

トランザクションが自動的にロールバックされる条件を指定します。 このパラメーターに使用できる値は次のとおりです。

  • Error 終了または終了しないエラーが発生した場合、トランザクションは自動的にロールバックされます。
  • TerminatingError 終了エラーが発生した場合、トランザクションは自動的にロールバックされます。
  • Never トランザクションが自動的にロールバックされることはありません。

既定値は Errorです。

型:RollbackSeverity
指定可能な値:Error, TerminatingError, Never
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Timeout

トランザクションがアクティブな最大時間を分単位で指定します。 タイムアウトが切れると、トランザクションは自動的にロールバックされます。

既定では、コマンド ラインで開始されるトランザクションのタイムアウトはありません。 トランザクションがスクリプトによって開始されると、既定のタイムアウトは 30 分です。

型:Int32
Aliases:TimeoutMins
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

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

出力

None

このコマンドレットは出力を生成しません。