about_Transactions

Korte beschrijving

Hierin wordt beschreven hoe u transacted bewerkingen beheert in PowerShell.

Lange beschrijving

Transacties worden ondersteund in PowerShell vanaf PowerShell 2.0. Met deze functie kunt u een transactie starten, aangeven welke opdrachten deel uitmaken van de transactie en een transactie doorvoeren of terugdraaien.

OVER TRANSACTIES

In PowerShell is een transactie een set van een of meer opdrachten die worden beheerd als een logische eenheid. Een transactie kan worden voltooid ('doorgevoerd'), waarmee gegevens worden gewijzigd die worden beïnvloed door de transactie. Of een transactie kan volledig ongedaan worden gemaakt ('teruggedraaid'), zodat de betrokken gegevens niet door de transactie worden gewijzigd.

Omdat de opdrachten in een transactie worden beheerd als een eenheid, worden alle opdrachten doorgevoerd of worden alle opdrachten teruggedraaid.

Transacties worden veel gebruikt in gegevensverwerking, met name in databasebewerkingen en voor financiële transacties. Transacties worden het vaakst gebruikt wanneer het slechtste scenario voor een set opdrachten niet is dat ze allemaal mislukken, maar dat sommige opdrachten slagen terwijl andere mislukken, waardoor het systeem een beschadigde, onwaar- of niet-leesbare status heeft die moeilijk te herstellen is.

TRANSACTIE-CMDLETS

PowerShell bevat verschillende cmdlets die zijn ontworpen voor het beheren van transacties.

  • Start-transactie: hiermee start u een nieuwe transactie.
  • Use-Transaction: hiermee voegt u een opdracht of expressie toe aan de transactie. De opdracht moet objecten met transactie-functionaliteit gebruiken.
  • Ongedaan maken van transactie: hiermee wordt de transactie teruggedraaid, zodat er geen gegevens door de transactie worden gewijzigd.
  • Volledige transactie: de transactie doorvoeren. De gegevens die worden beïnvloed door de transactie, worden gewijzigd.
  • Get-Transaction: haalt informatie over de actieve transactie op.

Voor een lijst met transactie-cmdlets typt u:

get-command *transaction

Voor gedetailleerde informatie over de cmdlets typt u:

get-help use-transaction -detailed

ELEMENTEN WAARVOOR TRANSACTIES ZIJN INGESCHAKELD

Als u wilt deelnemen aan een transactie, moeten zowel de cmdlet als de provider transacties ondersteunen. Deze functie is ingebouwd in de objecten die worden beïnvloed door de transactie.

De PowerShell-registerprovider ondersteunt transacties in Windows Vista. Het TransactedString-object (Microsoft.PowerShell.Commands.Management.TransactedString) werkt met elk besturingssysteem waarop PowerShell wordt uitgevoerd.

Andere PowerShell-providers kunnen transacties ondersteunen. Als u de PowerShell-providers in uw sessie wilt vinden die transacties ondersteunen, gebruikt u de volgende opdracht om de waarde 'Transacties' te vinden in de eigenschap Capabilities van providers:

get-psprovider | where {$_.Capabilities -like "*transactions*"}

Zie de Help voor de provider voor meer informatie over een provider. Als u hulp voor providers wilt ophalen, typt u:

get-help <provider-name>

Als u bijvoorbeeld Help voor de registerprovider wilt ophalen, typt u:

get-help registry

DE PARAMETER USETRANSACTION

Cmdlets die transacties kunnen ondersteunen, hebben een UseTransaction-parameter. Deze parameter bevat de opdracht in de actieve transactie. U kunt de volledige parameternaam of de alias usetx gebruiken.

De parameter kan alleen worden gebruikt wanneer de sessie een actieve transactie bevat. Als u een opdracht invoert met de parameter UseTransaction wanneer er geen actieve transactie is, mislukt de opdracht.

Als u cmdlets wilt zoeken met de parameter UseTransaction, typt u:

get-help * -parameter UseTransaction

In PowerShell Core ondersteunen alle cmdlets die zijn ontworpen om te werken met PowerShell-providers transacties. Als gevolg hiervan kunt u de provider-cmdlets gebruiken om transacties te beheren.

Zie about_Providers voor meer informatie over PowerShell-providers.

HET TRANSACTIEOBJECT

Transacties worden weergegeven in PowerShell door een transactieobject, System.Management.Automation.Transaction.

Het object heeft de volgende eigenschappen:

  • RollbackPreference: bevat de voorkeur voor terugdraaien ingesteld voor de huidige transactie. U kunt de voorkeur voor terugdraaien instellen wanneer u Start-Transaction gebruikt om de transactie te starten.

    De voorkeur voor terugdraaien bepaalt de voorwaarden waaronder de transactie automatisch wordt teruggedraaid. Geldige waarden zijn Fout, TerminatingError en Nooit. De standaardwaarde is Fout.

  • Status: Bevat de huidige status van de transactie. Geldige waarden zijn Actief, Doorgevoerd en RolledBack.

  • SubscriberCount: Bevat het aantal abonnees voor de transactie. Een abonnee wordt toegevoegd aan een transactie wanneer u een transactie start terwijl er een andere transactie wordt uitgevoerd. Het aantal abonnees wordt afgetrokken wanneer een abonnee de transactie doorvoert.

ACTIEVE TRANSACTIES

In PowerShell is slechts één transactie tegelijk actief en kunt u alleen de actieve transactie beheren. Meerdere transacties kunnen tegelijkertijd in dezelfde sessie worden uitgevoerd, maar alleen de meest recent gestarte transactie is actief.

Als gevolg hiervan kunt u geen bepaalde transactie opgeven wanneer u de transactie-cmdlets gebruikt. Opdrachten zijn altijd van toepassing op de actieve transactie.

Dit is het meest duidelijk in het gedrag van de Get-Transaction cmdlet. Wanneer u een Get-Transaction opdracht invoert, krijgt Get-Transaction altijd slechts één transactieobject. Dit object is het object dat de actieve transactie vertegenwoordigt.

Als u een andere transactie wilt beheren, moet u eerst de actieve transactie voltooien door deze door te voeren of terug te draaien. Wanneer u dit doet, wordt de vorige transactie automatisch actief. Transacties worden actief in de omgekeerde volgorde waarin ze worden gestart, zodat de meest recent gestarte transactie altijd actief is.

ABONNEES EN ONAFHANKELIJKE TRANSACTIES

Als u een transactie start terwijl er een andere transactie wordt uitgevoerd, start PowerShell standaard geen nieuwe transactie. In plaats daarvan wordt een 'abonnee' toegevoegd aan de huidige transactie.

Wanneer een transactie meerdere abonnees heeft, wordt met één Undo-Transaction opdracht op elk moment de hele transactie voor alle abonnees teruggedraaid. Als u de transactie wilt doorvoeren, moet u echter een Complete-Transaction opdracht invoeren voor elke abonnee.

Als u het aantal abonnees van een transactie wilt vinden, controleert u de eigenschap SubscriberCount van het transactieobject. Met de volgende opdracht wordt bijvoorbeeld de cmdlet Get-Transaction gebruikt om de waarde van de eigenschap SubscriberCount van de actieve transactie op te halen:

(Get-Transaction).SubscriberCount

Het toevoegen van een abonnee is het standaardgedrag omdat de meeste transacties die worden gestart terwijl een andere transactie wordt uitgevoerd, betrekking hebben op de oorspronkelijke transactie. In het typische model roept een script met een transactie een helperscript aan dat een eigen transactie bevat. Omdat de transacties gerelateerd zijn, moeten ze als eenheid worden teruggedraaid of doorgevoerd.

U kunt echter een transactie starten die onafhankelijk is van de huidige transactie met behulp van de onafhankelijke parameter van de Start-Transaction cmdlet.

Wanneer u een onafhankelijke transactie start, maakt Start-Transaction een nieuw transactieobject en wordt de nieuwe transactie de actieve transactie. De onafhankelijke transactie kan worden doorgevoerd of teruggedraaid zonder dat dit van invloed is op de oorspronkelijke transactie.

Wanneer de onafhankelijke transactie is voltooid (doorgevoerd of teruggedraaid), wordt de oorspronkelijke transactie opnieuw de actieve transactie.

GEGEVENS WIJZIGEN

Wanneer u transacties gebruikt om gegevens te wijzigen, worden de gegevens die worden beïnvloed door de transactie pas gewijzigd wanneer u de transactie doorvoert. Dezelfde gegevens kunnen echter worden gewijzigd door opdrachten die geen deel uitmaken van de transactie.

Houd hier rekening mee wanneer u transacties gebruikt om gedeelde gegevens te beheren. Databases hebben doorgaans mechanismen waarmee de gegevens worden vergrendeld terwijl u eraan werkt, waardoor andere gebruikers en andere opdrachten, scripts en functies deze niet kunnen wijzigen.

De vergrendeling is echter een functie van de database. Het is niet gerelateerd aan transacties. Als u werkt in een bestandssysteem met transactie of een ander gegevensarchief, kunnen de gegevens worden gewijzigd terwijl de transactie wordt uitgevoerd.

Voorbeelden

In de voorbeelden in deze sectie wordt de PowerShell-registerprovider gebruikt en ervan uitgegaan dat u er bekend mee bent. Typ 'get-help registry' voor informatie over de registerprovider.

VOORBEELD 1: EEN TRANSACTIE DOORVOEREN

Gebruik de cmdlet Start-Transaction om een transactie te maken. Met de volgende opdracht wordt een transactie gestart met de standaardinstellingen.

start-transaction

Als u opdrachten in de transactie wilt opnemen, gebruikt u de parameter UseTransaction van de cmdlet. Opdrachten zijn standaard niet opgenomen in de transactie,

De volgende opdracht, waarmee de huidige locatie in de softwaresleutel van de HKCU: station, wordt bijvoorbeeld niet opgenomen in de transactie.

cd hkcu:\Software

Met de volgende opdracht, waarmee de MyCompany-sleutel wordt gemaakt, wordt de useTransaction-parameter van de New-Item cmdlet gebruikt om de opdracht op te nemen in de actieve transactie.

new-item MyCompany -UseTransaction

De opdracht retourneert een object dat de nieuwe sleutel vertegenwoordigt, maar omdat de opdracht deel uitmaakt van de transactie, wordt het register nog niet gewijzigd.

Hive: HKEY_CURRENT_USER\Software

SKC  VC Name                           Property
---  -- ----                           --------
  0   0 MyCompany                      {}

Gebruik de cmdlet Complete-Transaction om de transactie door te voeren. Omdat dit altijd van invloed is op de actieve transactie, kunt u de transactie niet opgeven.

complete-transaction

Als gevolg hiervan wordt de MyCompany-sleutel toegevoegd aan het register.

dir m*
Hive: HKEY_CURRENT_USER\software

SKC  VC Name                           Property
---  -- ----                           --------
 83   1 Microsoft                      {(default)}
  0   0 MyCompany                      {}

VOORBEELD 2: EEN TRANSACTIE TERUGDRAAIEN

Gebruik de cmdlet Start-Transaction om een transactie te maken. Met de volgende opdracht wordt een transactie gestart met de standaardinstellingen.

start-transaction

Met de volgende opdracht, waarmee de MyOtherCompany-sleutel wordt gemaakt, wordt de UseTransaction-parameter van de New-Item cmdlet gebruikt om de opdracht op te nemen in de actieve transactie.

new-item MyOtherCompany -UseTransaction

De opdracht retourneert een object dat de nieuwe sleutel vertegenwoordigt, maar omdat de opdracht deel uitmaakt van de transactie, wordt het register nog niet gewijzigd.

Hive: HKEY_CURRENT_USER\Software

SKC  VC Name                           Property
---  -- ----                           --------
  0   0 MyOtherCompany                 {}

Gebruik de cmdlet Undo-Transaction om de transactie terug te draaien. Omdat dit altijd van invloed is op de actieve transactie, geeft u de transactie niet op.

Undo-transaction

Het resultaat is dat de MyOtherCompany-sleutel niet wordt toegevoegd aan het register.

dir m*
Hive: HKEY_CURRENT_USER\software

SKC  VC Name                           Property
---  -- ----                           --------
 83   1 Microsoft                      {(default)}
  0   0 MyCompany                      {}

VOORBEELD 3: EEN VOORBEELD VAN EEN TRANSACTIE BEKIJKEN

Normaal gesproken worden de opdrachten die worden gebruikt in een transactiewijzigingsgegevens. De opdrachten voor het ophalen van gegevens zijn echter ook handig in een transactie, omdat ze gegevens binnen de transactie ophalen. Dit biedt een voorbeeld van de wijzigingen die de transactie doorvoeren.

In het volgende voorbeeld ziet u hoe u de opdracht Get-ChildItem (de alias is dir) gebruikt om een voorbeeld van de wijzigingen in een transactie te bekijken.

Met de volgende opdracht wordt een transactie gestart.

start-transaction

De volgende opdracht maakt gebruik van de New-ItemProperty cmdlet om de registervermelding MyKey toe te voegen aan de MyCompany-sleutel. De opdracht maakt gebruik van de UseTransaction-parameter om de opdracht op te nemen in de transactie.

new-itemproperty -path MyCompany -Name MyKey -value 123 -UseTransaction

De opdracht retourneert een object dat de nieuwe registervermelding vertegenwoordigt, maar de registervermelding wordt niet gewijzigd.

MyKey
-----
123

Als u de items wilt ophalen die zich momenteel in het register bevinden, gebruikt u een Get-ChildItem opdracht ('dir') zonder de parameter UseTransaction. Met de volgende opdracht worden items opgehaald die beginnen met 'M'.

dir m*

Het resultaat laat zien dat er nog geen vermeldingen zijn toegevoegd aan de MyCompany-sleutel.

Hive: HKEY_CURRENT_USER\Software

SKC  VC Name                           Property
---  -- ----                           --------
 83   1 Microsoft                      {(default)}
  0   0 MyCompany                      {}

Als u een voorbeeld wilt bekijken van het effect van het doorvoeren van de transactie, voert u een opdracht Get-ChildItem ("dir") in met de parameter UseTransaction. Deze opdracht heeft een weergave van de gegevens vanuit de transactie.

dir m* -useTransaction

Het resultaat laat zien dat, als de transactie is doorgevoerd, de MyKey-vermelding wordt toegevoegd aan de MyCompany-sleutel.

Hive: HKEY_CURRENT_USER\Software

SKC  VC Name                           Property
---  -- ----                           --------
 83   1 Microsoft                      {(default)}
  0   1 MyCompany                      {MyKey}

VOORBEELD 4: TRANSACTED- EN NIET-TRANSACTED OPDRACHTEN COMBINEREN

U kunt niet-transacted opdrachten invoeren tijdens een transactie. De niet-uitgevoerde opdrachten zijn onmiddellijk van invloed op de gegevens, maar deze hebben geen invloed op de transactie. Met de volgende opdracht wordt een transactie gestart in de registersleutel HKCU:\Software.

start-transaction

De volgende drie opdrachten gebruiken de New-Item cmdlet om sleutels aan het register toe te voegen. De eerste en derde opdrachten gebruiken de parameter UseTransaction om de opdrachten in de transactie op te nemen. Met de tweede opdracht wordt de parameter weggelaten. Omdat de tweede opdracht niet is opgenomen in de transactie, is deze onmiddellijk van kracht.

new-item MyCompany1 -UseTransaction
new-item MyCompany2
new-item MyCompany3 -UseTransaction

Als u de huidige status van het register wilt weergeven, gebruikt u een opdracht Get-ChildItem ("dir") zonder de parameter UseTransaction. Met deze opdracht worden items opgehaald die beginnen met 'M'.

dir m*

Het resultaat laat zien dat de MyCompany2-sleutel wordt toegevoegd aan het register, maar dat de sleutels MyCompany1 en MyCompany3, die deel uitmaken van de transactie, niet worden toegevoegd.

Hive: HKEY_CURRENT_USER\Software

SKC  VC Name                           Property
---  -- ----                           --------
 83   1 Microsoft                      {(default)}
  0    0 MyCompany2                     {}

Met de volgende opdracht wordt de transactie doorgevoerd.

complete-transaction

Nu worden de sleutels die zijn toegevoegd als onderdeel van de transactie, weergegeven in het register.

dir m*
Hive: HKEY_CURRENT_USER\Software

SKC  VC Name                           Property
---  -- ----                           --------
83   1 Microsoft                      {(default)}
0    0 MyCompany1                     {}
0    0 MyCompany2                     {}
0    0 MyCompany3                     {}

VOORBEELD 5: AUTOMATISCHE TERUGDRAAIBEWERKING GEBRUIKEN

Wanneer een opdracht in een transactie een fout van welke aard dan ook genereert, wordt de transactie automatisch teruggedraaid.

Dit standaardgedrag is ontworpen voor scripts die transacties uitvoeren. Scripts zijn doorgaans goed getest en bevatten logica voor foutafhandeling, dus fouten worden niet verwacht en moeten de transactie beëindigen.

Met de eerste opdracht wordt een transactie gestart in de registersleutel HKCU:\Software.

start-transaction

Met de volgende opdracht wordt de cmdlet New-Item gebruikt om de MyCompany-sleutel toe te voegen aan het register. De opdracht maakt gebruik van de useTransaction-parameter (de alias is usetx) om de opdracht in de transactie op te nemen.

New-Item MyCompany -UseTX

Omdat de MyCompany-sleutel al in het register bestaat, mislukt de opdracht en wordt de transactie teruggedraaid.

New-Item : A key at this path already exists
At line:1 char:9
+ new-item <<<<  MyCompany -usetx

Een Get-Transaction opdracht bevestigt dat de transactie is teruggedraaid en dat de SubscriberCount 0 is.

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

VOORBEELD 6: DE TERUGDRAAIVOORKEUR WIJZIGEN

Als u wilt dat de transactie meer fouttolerant is, kunt u de parameter RollbackPreference van Start-Transaction gebruiken om de voorkeur te wijzigen.

Met de volgende opdracht wordt een transactie gestart met een terugdraaivoorkeur van 'Nooit'.

start-transaction -rollbackpreference Never

Wanneer de opdracht mislukt, wordt de transactie in dit geval niet automatisch teruggedraaid.

New-Item MyCompany -UseTX
New-Item : A key at this path already exists
At line:1 char:9
+ new-item <<<<  MyCompany -usetx

Omdat de transactie nog steeds actief is, kunt u de opdracht opnieuw indienen als onderdeel van de transactie.

New-Item MyOtherCompany -UseTX

VOORBEELD 7: DE CMDLET USE-TRANSACTION GEBRUIKEN

Met de cmdlet Use-Transaction kunt u directe scripting uitvoeren op Microsoft .NET Framework-objecten met transactie-functionaliteit. Use-Transaction gebruikt een scriptblok dat alleen opdrachten en expressies kan bevatten die gebruikmaken van .NET Framework objecten waarvoor transacties zijn ingeschakeld, zoals exemplaren van de klasse Microsoft.PowerShell.Commands.Management.TransactedString.

Met de volgende opdracht wordt een transactie gestart.

start-transaction

Met de volgende New-Object opdracht wordt een exemplaar van de TransactedString-klasse gemaakt en opgeslagen in de variabele $t.

$t = New-Object Microsoft.PowerShell.Commands.Management.TransactedString

De volgende opdracht gebruikt de methode Toevoegen van het Object TransactedString om tekst toe te voegen aan de tekenreeks. Omdat de opdracht geen deel uitmaakt van de transactie, is de wijziging onmiddellijk van kracht.

$t.append("Windows")

De volgende opdracht gebruikt dezelfde methode Toevoegen om tekst toe te voegen, maar voegt de tekst toe als onderdeel van de transactie. De opdracht staat tussen accolades en wordt ingesteld als de waarde van de ScriptBlock-parameter van Use-Transaction. De UseTransaction-parameter (UseTx) is vereist.

use-transaction {$t.append(" PowerShell")} -usetx

Als u de huidige inhoud van de transacted string in $t wilt zien, gebruikt u de Methode ToString van het Object TransactedString.

$t.tostring()

In de uitvoer ziet u dat alleen de niet-doorgevoerde wijzigingen effectief zijn.

Windows

Als u de huidige inhoud van de transacted string in $t vanuit de transactie wilt zien, sluit u de expressie in in een Use-Transaction opdracht.

use-transaction {$s.tostring()} -usetx

De uitvoer toont de transactieweergave.

PowerShell

Met de volgende opdracht wordt de transactie doorgevoerd.

complete-transaction

De laatste tekenreeks weergeven:

$t.tostring()
PowerShell

VOORBEELD 8: TRANSACTIES MET MEERDERE ABONNEES BEHEREN

Wanneer u een transactie start terwijl er een andere transactie wordt uitgevoerd, maakt PowerShell standaard geen tweede transactie. In plaats daarvan wordt een abonnee toegevoegd aan de huidige transactie.

In dit voorbeeld ziet u hoe u een transactie met meerdere abonnees kunt weergeven en beheren.

Begin met het starten van een transactie in de HKCU:\Software-sleutel.

start-transaction

Met de volgende opdracht wordt de opdracht Get-Transaction gebruikt om de actieve transactie op te halen.

get-transaction

Het resultaat toont het object dat de actieve transactie vertegenwoordigt.

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

Met de volgende opdracht wordt de MyCompany-sleutel aan het register toegevoegd. De opdracht maakt gebruik van de UseTransaction-parameter om de opdracht op te nemen in de transactie.

new-item MyCompany -UseTransaction

Met de volgende opdracht wordt de opdracht Start-Transaction gebruikt om een transactie te starten. Hoewel deze opdracht wordt getypt bij de opdrachtprompt, is dit scenario waarschijnlijker wanneer u een script uitvoert dat een transactie bevat.

start-transaction

Een Get-Transaction opdracht laat zien dat het aantal abonnees op het transactieobject wordt verhoogd. De waarde is nu 2.

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

De volgende opdracht maakt gebruik van de New-ItemProperty cmdlet om de registervermelding MyKey toe te voegen aan de MyCompany-sleutel. De parameter UseTransaction wordt gebruikt om de opdracht in de transactie op te nemen.

new-itemproperty -path MyCompany -name MyKey -UseTransaction

De MyCompany-sleutel bestaat niet in het register, maar deze opdracht slaagt omdat de twee opdrachten deel uitmaken van dezelfde transactie.

Met de volgende opdracht wordt de transactie doorgevoerd. Als de transactie wordt teruggedraaid, wordt de transactie teruggedraaid voor alle abonnees.

complete-transaction

Een Get-Transaction opdracht laat zien dat het aantal abonnees op het transactieobject 1 is, maar de waarde van status is nog steeds actief (niet doorgevoerd).

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

Voer een tweede opdracht Complete- Transaction in om het doorvoeren van de transactie te voltooien. Als u een transactie met meerdere abonnees wilt doorvoeren, moet u één Complete-Transaction opdracht invoeren voor elke Start-Transaction opdracht.

complete-transaction

Een andere Get-Transaction opdracht laat zien dat de transactie is doorgevoerd.

RollbackPreference   SubscriberCount   Status
------------------   ---------------   ------
Error                0                 Committed

VOORBEELD 9: ONAFHANKELIJKE TRANSACTIES BEHEREN

Wanneer u een transactie start terwijl er een andere transactie wordt uitgevoerd, kunt u de onafhankelijke parameter van Start-Transaction gebruiken om de nieuwe transactie onafhankelijk te maken van de oorspronkelijke transactie.

Wanneer u dit doet, maakt Start-Transaction een nieuw transactieobject en maakt u de nieuwe transactie de actieve transactie.

Begin met het starten van een transactie in de HKCU:\Software-sleutel.

start-transaction

Met de volgende opdracht wordt de opdracht Get-Transaction gebruikt om de actieve transactie op te halen.

get-transaction

Het resultaat toont het object dat de actieve transactie vertegenwoordigt.

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

Met de volgende opdracht wordt de registersleutel MyCompany toegevoegd als onderdeel van de transactie. De parameter UseTransaction (UseTx) wordt gebruikt om de opdracht in de actieve transactie op te nemen.

new-item MyCompany -use

Met de volgende opdracht wordt een nieuwe transactie gestart. De opdracht maakt gebruik van de onafhankelijke parameter om aan te geven dat deze transactie geen abonnee is van de actieve transactie.

start-transaction -independent

Wanneer u een onafhankelijke transactie maakt, wordt de nieuwe (meest recent gemaakte) transactie de actieve transactie. U kunt een Get-Transaction opdracht gebruiken om de actieve transactie op te halen.

get-transaction

Houd er rekening mee dat de SubscriberCount van de transactie 1 is, wat aangeeft dat er geen andere abonnees zijn en dat de transactie nieuw is.

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

De nieuwe transactie moet zijn voltooid (doorgevoerd of teruggedraaid) voordat u de oorspronkelijke transactie kunt beheren.

Met de volgende opdracht wordt de MyOtherCompany-sleutel toegevoegd aan het register. De parameter UseTransaction (UseTx) wordt gebruikt om de opdracht in de actieve transactie op te nemen.

new-item MyOtherCompany -usetx

Draai nu de transactie terug. Als er één transactie met twee abonnees was, zou het terugdraaien van de transactie de hele transactie voor alle abonnees terugdraaien.

Omdat deze transacties echter onafhankelijk zijn, annuleert het terugdraaien van de nieuwste transactie de registerwijzigingen en brengt u de oorspronkelijke transactie de actieve transactie aan.

undo-transaction

Een Get-Transaction opdracht bevestigt dat de oorspronkelijke transactie nog steeds actief is in de sessie.

get-transaction
RollbackPreference   SubscriberCount   Status
------------------   ---------------   ------
Error                1                 Active

Met de volgende opdracht wordt de actieve transactie doorgevoerd.

complete-transaction

Een Get-ChildItem opdracht laat zien dat het register is gewijzigd.

dir m*
Hive: HKEY_CURRENT_USER\Software

SKC  VC Name                           Property
---  -- ----                           --------
 83   1 Microsoft                      {(default)}
  0   0 MyCompany                      {}

Zie ook