次の方法で共有

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

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