Get-Transaction

Get-Transaction

Cmdleten Get-Transaction hämtar ett objekt som representerar den aktuella transaktionen i sessionen.

Den här cmdleten returnerar aldrig fler än ett objekt, eftersom endast en transaktion är aktiv i taget. Om du startar en eller flera oberoende transaktioner (med hjälp av den oberoende parametern för Start-Transaction) är den senast startade transaktionen aktiv och det är den transaktion som Get-Transaction returnerar.

När alla aktiva transaktioner antingen har återställts eller checkats in visar den här cmdleten transaktionen som senast var aktiv i sessionen.

Den här cmdleten är en av en uppsättning cmdletar som stöder transaktionsfunktionen i Windows PowerShell. Mer information finns i about_Transactions.

Start-Transaction
Get-Transaction

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

Det här kommandot använder cmdleten Get-Transaction för att hämta den aktuella transaktionen.

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;}

Det här kommandot använder cmdleten Get-Member för att visa egenskaperna och metoderna för transaktionsobjektet.

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

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

Det här kommandot visar egenskapsvärdena för ett transaktionsobjekt för en transaktion som har återställts.

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

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

Det här kommandot visar egenskapsvärdena för ett transaktionsobjekt för en transaktion som har checkats in.

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

Det här exemplet visar effekten på transaktionsobjektet för att starta en transaktion medan en annan transaktion pågår. Detta inträffar vanligtvis när ett skript som kör en transaktion innehåller en funktion eller anropar ett skript som innehåller en annan fullständig transaktion.

Om inte det andra Start-Transaction-kommandot innehåller parametern Independent skapar Start-Transaction ingen ny transaktion. I stället läggs en andra prenumerant till den ursprungliga transaktionen.

Det första kommandot Start-Transaction startar transaktionen. Ett New-Item-kommando med parametern UseTransaction ingår i transaktionen.

Ett andra Start-Transaction-kommando lägger till en prenumerant i transaktionen. Nästa New-Item kommando är också en del av transaktionen.

Det första kommandot Get-Transaction visar transaktionen för flera prenumeranter. Observera att antalet prenumeranter är 2.

Det första Complete-Transaction-kommandot checkar inte in transaktionen, men det minskar antalet prenumeranter till 1.

Det andra Complete-Transaction-kommandot checkar in transaktionen.

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

Det här exemplet visar effekten på transaktionsobjektet att starta en oberoende transaktion medan en annan transaktion pågår.

Det första kommandot Start-Transaction startar transaktionen. Ett New-Item-kommando med parametern UseTransaction ingår i transaktionen.

Ett andra Start-Transaction-kommando lägger till en prenumerant i transaktionen. Nästa New-Item kommando är också en del av transaktionen.

Det första kommandot Get-Transaction visar transaktionen för flera prenumeranter. Observera att antalet prenumeranter är 2.

Kommandot Complete-Transaction minskar antalet prenumeranter till 1, men transaktionen checkas inte in.

Det andra Complete-Transaction-kommandot checkar in transaktionen.

Du kan inte skicka objekt till den här cmdleten.

Den här cmdleten returnerar ett objekt som representerar den aktuella transaktionen.