Use-Transaction

Use-Transaction cmdlet 向活动事务添加脚本块。 这使你能够使用启用了事务的Microsoft .NET Framework 对象执行事务处理脚本。 脚本块只能包含启用了事务的 .NET Framework 对象，例如 Microsoft.PowerShell.Commands.Management.TransactedString 类的实例。

使用此 cmdlet 时，UseTransaction 参数是可选的。

Use-Transaction 是一组支持 Windows PowerShell 中的事务功能的 cmdlet 之一。 有关详细信息，请参阅 about_Transactions。

Start-Transaction
$transactedString = New-Object Microsoft.PowerShell.Commands.Management.TransactedString
$transactedString.Append("Hello")
Use-Transaction -TransactedScript { $transactedString.Append(", World") } -UseTransaction
$transactedString.ToString()

Hello

Use-Transaction -TransactedScript { $transactedString.ToString() } -UseTransaction

Hello, World

Complete-Transaction
$transactedString.ToString()

Hello, World

此示例演示如何使用 Use-Transaction 针对启用了事务的 .NET Framework 对象编写脚本。 在本例中，该对象是一个 TransactedString 对象。

第一个命令使用 Start-Transaction cmdlet 启动事务。

第二个命令使用 New-Object 命令创建 TransactedString 对象。 它将对象存储在 $TransactedString 变量中。

第三个和第四个命令都使用 TransactedString 对象的 Append 方法将文本添加到 $TransactedString的值。 一个命令是事务的一部分。 另一个命令不是。

第三个命令使用事务处理字符串的 Append 方法将 Hello 添加到 $TransactedString的值。 由于命令不是事务的一部分，因此将立即应用更改。

第四个命令使用 Use-Transaction 将文本添加到事务中的字符串。 该命令使用 Append 方法将“，World”添加到 $TransactedString的值。 命令用大括号（{}）括起来，使其成为脚本块。 此命令中需要 UseTransaction 参数。

第五和第六个命令使用 TransactedString 对象的 ToString 方法将 TransactedString 的值显示为字符串。 同样，一个命令是事务的一部分。 另一个事务不是。

第五个命令使用 ToString 方法显示$TransactedString变量的当前值。 由于它不是事务的一部分，因此它仅显示字符串的当前状态。

第六个命令使用 Use-Transaction 在事务中运行相同的命令。 由于该命令是事务的一部分，因此它在事务中显示字符串的当前值，这与事务更改的预览非常类似。

第七个命令使用 Complete-Transaction cmdlet 提交事务。

最后一个命令使用 ToString 方法将变量的结果值显示为字符串。

Start-Transaction
$transactedString = New-Object Microsoft.PowerShell.Commands.Management.TransactedString
$transactedString.Append("Hello")
Use-Transaction -TransactedScript { $transactedString.Append(", World") } -UseTransaction
Undo-Transaction
$transactedString.ToString()

Hello

此示例显示回滚包含 Use-Transaction 命令的事务的效果。 与事务中的所有命令一样，在回滚事务时，将放弃事务处理更改，并且数据保持不变。

第一个命令使用 Start-Transaction 启动事务。

第二个命令使用 New-Object 创建 TransactedString 对象。 它将对象存储在 $TransactedString 变量中。

第三个命令不是事务的一部分，它使用 Append 方法将“Hello”添加到 $TransactedString的值。

第四个命令使用 Use-Transaction 运行另一个命令，该命令使用事务中的 Append 方法。 该命令使用 Append 方法将“，World”添加到 $TransactedString的值。

第五个命令使用 Undo-Transaction cmdlet 回滚事务。 因此，在事务中执行的所有命令都是相反的。

最后一个命令使用 ToString 方法将 $TransactedString 的结果值显示为字符串。 结果显示，仅对对象应用了事务外部所做的更改。

None

不能通过管道将输入传递给此 cmdlet。

PSObject

此 cmdlet 返回事务的结果。

• UseTransaction 参数包括活动事务中的命令。 由于 Use-Transaction cmdlet 始终用于事务，因此此参数需要使任何 Use-Transaction 命令生效。