Delen via

Complete-Transaction

  • Referentie
Module:
Microsoft.PowerShell.Management

De actieve transactie doorvoert.

Syntaxis

Complete-Transaction
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]

Description

Met de Complete-Transaction cmdlet wordt een actieve transactie doorgevoerd. Wanneer u een transactie doorvoert, worden de opdrachten in de transactie voltooid en worden de gegevens gewijzigd die worden beïnvloed door de opdrachten.

Als de transactie meerdere abonnees bevat, moet u één Complete-Transaction opdracht invoeren voor elke Start-Transaction opdracht.

De Complete-Transaction cmdlet is een van een set cmdlets die ondersteuning bieden voor de transactiefunctie in Windows PowerShell. Zie about_Transactionsvoor meer informatie.

Voorbeelden

Voorbeeld 1: Een transactie doorvoeren

Set-Location HKCU:\software
Start-Transaction
New-Item MyCompany -UseTransaction
Get-ChildItem m*

Hive: HKEY_CURRENT_USER\software

SKC  VC Name                           Property
---  -- ----                           --------
82   1 Microsoft                      {(default)}

Complete-Transaction
Get-ChildItem m*

Hive: HKEY_CURRENT_USER\Software

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

In dit voorbeeld ziet u wat er gebeurt wanneer u de Complete-Transaction-cmdlet gebruikt om een transactie door te voeren.

Met de opdracht Start-Transaction wordt de transactie gestart. De opdracht New-Item maakt gebruik van de parameter UseTransaction om de opdracht in de transactie op te nemen.

De eerste Get-ChildItem opdracht geeft aan dat het nieuwe item nog niet is toegevoegd aan het register.

De Complete-Transaction opdracht voert de transactie door, waardoor de registerwijziging van kracht wordt. Als gevolg hiervan geeft de tweede Get-ChildItem opdracht aan dat het register is gewijzigd.

Voorbeeld 2: Een transactie doorvoeren met meer dan één abonnee

Set-Location HKCU:\software
Start-Transaction
New-Item MyCompany -UseTransaction

Hive: HKEY_CURRENT_USER\Software

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

Start-Transaction
Get-Transaction

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

New-ItemProperty -Path MyCompany -Name MyKey -Value -UseTransaction

MyKey
-----
123

Complete-Transaction
Get-Transaction

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

Get-ChildItem m*

Hive: HKEY_CURRENT_USER\Software

SKC  VC Name                           Property
---  -- ----                           --------
82   1 Microsoft                      {(default)}

Complete-Transaction
Get-ChildItem m*

Hive: HKEY_CURRENT_USER\Software

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

In dit voorbeeld ziet u hoe u Complete-Transaction gebruikt voor het doorvoeren van een transactie met meer dan één abonnee.

Als u een transactie met meerdere abonnees wilt doorvoeren, moet u één Complete-Transaction opdracht invoeren voor elke Start-Transaction opdracht. De gegevens worden alleen gewijzigd wanneer de laatste Complete-Transaction opdracht wordt verzonden.

Voor demonstratiedoeleinden toont dit voorbeeld een reeks opdrachten die op de opdrachtregel zijn ingevoerd. In de praktijk worden transacties waarschijnlijk uitgevoerd in scripts, waarbij de secundaire transactie wordt uitgevoerd door een functie of helperscript dat wordt aangeroepen door het hoofdscript.

In dit voorbeeld start een Start-Transaction opdracht de transactie. Een New-Item opdracht met de parameter UseTransaction voegt de MyCompany-sleutel toe aan de softwaresleutel. Hoewel de cmdlet New-Item een sleutelobject retourneert, worden de gegevens in het register nog niet gewijzigd.

Met een tweede Start-Transaction opdracht wordt een tweede abonnee aan de bestaande transactie toegevoegd. De Get-Transaction cmdlet bevestigt dat het aantal abonnees 2 is. Een New-ItemProperty-opdracht met de parameter UseTransaction voegt een registervermelding toe aan de nieuwe MyCompany-sleutel. Opnieuw retourneert de opdracht een waarde, maar het register wordt niet gewijzigd.

De eerste Complete-Transaction opdracht vermindert het aantal abonnees met 1. Dit wordt bevestigd door een Get-Transaction opdracht. Er worden echter geen gegevens gewijzigd, zoals wordt aangetoond door een Get-ChildItem m* opdracht.

Met de tweede Complete-Transaction opdracht wordt de hele transactie doorgevoerd en worden de gegevens in het register gewijzigd. Dit wordt bevestigd door een tweede Get-ChildItem m* opdracht, waarin de wijzigingen worden weergegeven.

Voorbeeld 3: Een transactie uitvoeren die geen gegevens wijzigt

Set-Location HKCU:\software
Start-Transaction
New-Item MyCompany -UseTransaction
Get-ChildItem m*

Hive: HKEY_CURRENT_USER\Software

SKC  VC Name                           Property
---  -- ----                           --------
82   1 Microsoft                      {(default)}

Get-ChildItem m* -UseTransaction

Hive: HKEY_CURRENT_USER\Software

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

Complete-Transaction

In dit voorbeeld ziet u de waarde van het gebruik van Get-*-opdrachten en andere opdrachten die geen gegevens wijzigen in een transactie. Wanneer een Get-\* opdracht wordt gebruikt in een transactie, worden de objecten opgehaald die deel uitmaken van de transactie. Hiermee kunt u een voorbeeld van de wijzigingen in de transactie bekijken voordat de wijzigingen worden doorgevoerd.

In dit voorbeeld wordt een transactie gestart. Een New-Item-opdracht met de parameter UseTransaction voegt een nieuwe sleutel toe aan het register als onderdeel van de transactie.

Omdat de nieuwe registersleutel pas aan het register wordt toegevoegd nadat de opdracht Complete-Transaction is uitgevoerd, wordt met een eenvoudige Get-ChildItem opdracht het register zonder de nieuwe sleutel weergegeven.

Wanneer u echter de parameter UseTransaction toevoegt aan de opdracht Get-ChildItem, wordt de opdracht onderdeel van de transactie en worden de items in de transactie opgehaald, zelfs als ze nog niet aan de gegevens zijn toegevoegd.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Met deze cmdlet wordt geen uitvoer gegenereerd.

Notities

  • U kunt een transactie die is doorgevoerd, niet terugdraaien of een transactie doorvoeren die is teruggedraaid.

    U kunt geen andere transactie terugdraaien dan de actieve transactie. Als u een andere transactie wilt terugdraaien, moet u eerst de actieve transactie doorvoeren of terugdraaien.

    Als een deel van een transactie niet kan worden doorgevoerd, bijvoorbeeld wanneer een opdracht in de transactie een fout oplevert, wordt de hele transactie teruggedraaid.