次の方法で共有

Get-Transaction

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

現在の (アクティブな) トランザクションを取得します。

構文

Get-Transaction []

説明

Get-Transaction コマンドレットは、セッション内の現在のトランザクションを表すオブジェクトを取得します。

一度にアクティブなトランザクションは 1 つだけであるため、このコマンドレットは複数のオブジェクトを返しません。 (Start-Transactionの独立したパラメーターを使用して) 1 つ以上の独立したトランザクションを開始すると、最後に開始されたトランザクションがアクティブになり、Get-Transaction が返すトランザクションになります。

アクティブなすべてのトランザクションがロールバックまたはコミットされると、このコマンドレットはセッションで最後にアクティブだったトランザクションを表示します。

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

例

例 1: 現在のトランザクションを取得する

Start-Transaction
Get-Transaction

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

このコマンドでは、Get-Transaction コマンドレットを使用して現在のトランザクションを取得します。

例 2: トランザクション オブジェクトのプロパティとメソッドを表示する

Get-Transaction | Get-Member

Name               MemberType Definition
----               ---------- ----------
Dispose            Method     System.Void Dispose(), System.Void Dispose(Boolean disposing)
Equals             Method     System.Boolean Equals(Object obj)
GetHashCode        Method     System.Int32 GetHashCode()
GetType            Method     System.Type GetType()
ToString           Method     System.String ToString()
IsCommitted        Property   System.Boolean IsCommitted {get;}
IsRolledBack       Property   System.Boolean IsRolledBack {get;}
RollbackPreference Property   System.Management.Automation.RollbackSeverity RollbackPreference {get;}
SubscriberCount    Property   System.Int32 SubscriberCount {get;set;}

このコマンドでは、Get-Member コマンドレットを使用して、トランザクション オブジェクトのプロパティとメソッドを表示します。

例 3: ロールバックトランザクションのプロパティ値を表示する

Set-Location hklm:\software
Start-Transaction
New-Item MyCompany -UseTransaction
Undo-Transaction
Get-Transaction

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

このコマンドは、ロールバックされたトランザクションのトランザクション オブジェクトのプロパティ値を表示します。

例 4: コミットされたトランザクションのプロパティ値を表示する

Set-Location hklm:\software
Start-Transaction
New-Item MyCompany -UseTransaction
Complete-Transaction
Get-Transaction

RollbackPreference   SubscriberCount   Status
------------------   ---------------   ---------
Error                1                 Committed

このコマンドは、コミットされたトランザクションのトランザクション オブジェクトのプロパティ値を示します。

例 5: 別のトランザクションの進行中にトランザクションを開始する

Set-Location hklm:\software
Start-Transaction
New-Item MyCompany -UseTransaction
Start-Transaction
New-Item MyCompany2 -UseTransaction
Get-Transaction

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

Complete-Transaction
Get-Transaction

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

Complete-Transaction
Get-Transaction

RollbackPreference   SubscriberCount   Status
------------------   ---------------   ---------
Error                1                 Committed

この例では、別のトランザクションの進行中にトランザクションを開始したトランザクション オブジェクトに対する影響を示します。 通常、これは、トランザクションを実行するスクリプトに関数が含まれている場合、または別の完全なトランザクションを含むスクリプトを呼び出す場合に発生します。

2 番目の Start-Transaction コマンドに Independent パラメーターが含まれていない限り、Start-Transaction は新しいトランザクションを作成しません。 代わりに、元のトランザクションに 2 番目のサブスクライバーを追加します。

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

2 番目の Start-Transaction コマンドは、サブスクライバーをトランザクションに追加します。 次の New-Item コマンドもトランザクションの一部です。

最初の Get-Transaction コマンドは、マルチサブスクライバー トランザクションを示しています。 サブスクライバー数が 2 であることに注意してください。

最初の Complete-Transaction コマンドはトランザクションをコミットしませんが、サブスクライバー数を 1 に減らします。

2 番目の Complete-Transaction コマンドは、トランザクションをコミットします。

例 6: 別のトランザクションの進行中に独立したトランザクションを開始する

Set-Location hklm:\software
Start-Transaction
Get-Transaction

RollbackPreference   SubscriberCount   IsRolledBack   IsCommitted
------------------   ---------------   ------------   -----------
Error                1                 False          False

Start-Transaction -Independent
Get-Transaction

RollbackPreference   SubscriberCount   IsRolledBack   IsCommitted
------------------   ---------------   ------------   -----------
Error                1                 False          False

Complete-Transaction
Get-Transaction
Complete-Transaction
Get-Transaction

この例では、別のトランザクションの進行中に独立したトランザクションを開始したトランザクション オブジェクトに対する影響を示します。

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

2 番目の Start-Transaction コマンドは、サブスクライバーをトランザクションに追加します。 次の New-Item コマンドもトランザクションの一部です。

最初の Get-Transaction コマンドは、マルチサブスクライバー トランザクションを示しています。 サブスクライバー数は 2 であることに注意してください。

Complete-Transaction コマンドはサブスクライバー数を 1 に減らしますが、トランザクションはコミットしません。

2 番目の Complete-Transaction コマンドは、トランザクションをコミットします。

入力

None

このコマンドレットにオブジェクトをパイプすることはできません。

出力

PSTransaction

このコマンドレットは、現在のトランザクションを表すオブジェクトを返します。