Undo-Transaction

Roll back the active transaction.

Syntax
       Undo-Transaction [-Confirm] [-WhatIf] [CommonParameters]

Key
   -Confirm
       Prompt for confirmation before executing the command.

   -WhatIf
       Describe what would happen if you executed the command without actually executing it.

   CommonParameters:
       -Verbose, -Debug, -ErrorAction, -ErrorVariable, -WarningAction, -WarningVariable,
       -OutBuffer -OutVariable.

Undo-Transaction rolls back the active transaction. When a transaction is rolled back , the changes made by commands within the transaction are discarded and the data is restored to its original form.

If the transaction includes multiple subscribers, an Undo-Transaction command rolls back the entire transaction for all subscribers.

By default, transactions are rolled back automatically if any command in the transaction generates an error. However, transactions can be started with a different rollback preference and you can use this cmdlet to roll back the active transaction at any time.

Examples

Start a transaction and then roll it back (undo) so that no changes are made:

PS C:\> cd hkcu:\software
PS HKCU:\Software> start-transaction
PS HKCU:\Software> new-item SS64 -usetransaction
PS HKCU:\Software> undo-transaction

“That glittering hope is immemorial and beckons many men to their undoing” ~ Euripides

Related:

Start-Transaction - Start a new transaction
Complete-Transaction
- Commit the transaction
Get-Transaction - Get information about the active transaction


© Copyright SS64.com 1999-2014
Some rights reserved