Get-Transaction

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

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

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

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

PS C:\> Start-Transaction
PS C:\> Get-Transaction

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

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

PS C:\> 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 コマンドレットを使用して、トランザクション オブジェクトのプロパティとメソッドを表示します。

PS C:\> cd hklm:\software
HKLM:\SOFTWARE> Start-Transaction
HKLM:\SOFTWARE> New-Item MyCompany -UseTransaction
HKLM:\SOFTWARE> Undo-Transaction
HKLM:\SOFTWARE> Get-Transaction

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

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

PS C:\> cd hklm:\software
HKLM:\SOFTWARE> Start-Transaction
HKLM:\SOFTWARE> New-Item MyCompany -UseTransaction
HKLM:\SOFTWARE> Complete-Transaction
HKLM:\SOFTWARE> Get-Transaction

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

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

PS C:\> cd hklm:\software
HKLM:\SOFTWARE> Start-Transaction
HKLM:\SOFTWARE> New-Item MyCompany -UseTransaction
HKLM:\SOFTWARE> Start-Transaction
HKLM:\SOFTWARE> New-Item MyCompany2 -UseTransaction
HKLM:\SOFTWARE> Get-Transaction

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

HKLM:\SOFTWARE> Complete-Transaction
HKLM:\SOFTWARE> Get-Transaction

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

HKLM:\SOFTWARE> Complete-Transaction
HKLM:\SOFTWARE> 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 コマンドは、トランザクションをコミットします。

PS C:\>
HKLM:\SOFTWARE> Start-Transaction
HKLM:\SOFTWARE> Get-Transaction

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

HKLM:\SOFTWARE> Start-Transaction -Independent
HKLM:\SOFTWARE> Get-Transaction

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

HKLM:\SOFTWARE> Complete-Transaction
HKLM:\SOFTWARE> Get-Transaction
HKLM:\SOFTWARE> Complete-Transaction
HKLM:\SOFTWARE> Get-Transaction

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

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

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

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

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

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

None

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

PSTransaction

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