Use-Transaction

Add a script block to the active transaction.

Syntax
      Use-Transaction [-TransactedScript] scriptblock 
         [-UseTransaction] [CommonParameters]

Key
   -TransactedScript scriptblock
      The script block that is run in the transaction.
      Enter any valid script block enclosed in braces {  }
      This parameter is required.

   -UseTransaction
       Include the command in the active transaction.

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

Examples

Show the effect of rolling back a transaction that includes Use-Transaction commands. When the transaction is rolled back, the transacted changes are discarded and the data is unchanged:

PS C:\> Start-transaction
PS C:\> $myTxString = New-Object Microsoft.PowerShell.Commands.Management.TransactedString
PS C:\> $myTxString.Append("Hello")
PS C:\> use-transaction -TransactedScript { $myTxString.Append(", World") } -UseTransaction
PS C:\> Undo-transaction
PS C:\> $myTxString.ToString()
Hello

“Two roads diverged in a wood, and I, I took the one less traveled by, And that has made all the difference” ~ Robert Frost (The Road Not Taken)

Related:

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


© Copyright SS64.com 1999-2013
Some rights reserved