简短说明
介绍如何在 PowerShell 中管理事务处理操作。
详细说明
从 PowerShell 2.0 开始，PowerShell 支持事务。 此功能使你能够启动事务，指示哪些命令是事务的一部分，以及提交或回滚事务。
关于交易
在 PowerShell 中，事务是作为逻辑单元进行管理的一个或多个命令。 可以完成事务（“提交”），这会更改受事务影响的数据。 或者，事务可以完全撤消（“回滚”），以便事务不会更改受影响的数据。
由于事务中的命令作为一个单元进行管理，因此所有命令不是全部提交就是全部回滚。
事务广泛应用于数据处理，尤其是数据库操作和财务事务。 当一组命令的最坏情况不是它们全部失败，而是某些命令成功而另一些命令失败，使系统处于难以修复的损坏、错误或无法解释的状态时，最常使用事务。
事务 CMDLET
PowerShell 包含多个用于管理事务的 cmdlet。
- Start-Transaction：启动新事务。
- Use-Transaction：向事务添加命令或表达式。 该命令必须使用支持事务的对象。
- Undo-Transaction：回滚事务，以便事务不会更改任何数据。
- Complete-Transaction：提交事务。 会更改受事务影响的数据。
- Get-Transaction：获取有关活动事务的信息。
如需事务 cmdlet 的列表，请键入：
get-command *transaction
如需有关 cmdlet 的详细信息，请键入：
get-help use-transaction -detailed
TRANSACTION-ENABLED ELEMENTS 元素
若要参与事务，cmdlet 和提供程序都必须支持事务。 此功能内置于受事务影响的对象中。
PowerShell 注册表提供程序支持 Windows Vista 中的事务。 TransactedString 对象 （Microsoft.PowerShell.Commands.Management.TransactedString） 适用于运行 PowerShell 的任何作系统。
其他 PowerShell 提供程序可以支持事务。 要在会话中查找支持事务的 PowerShell 提供程序，请使用以下命令在提供程序的 Capabilities 属性中查找 “Transactions” 值：
get-psprovider | where {$_.Capabilities -like "transactions"}
有关提供程序的详细信息，请参阅提供程序的帮助。 要获取提供商帮助，请键入：
get-help <provider-name>
例如，若要获取有关 Registr 提供程序的帮助，请键入：
get-help registry
USETRANSACTION 参数
可以支持事务的 Cmdlet 具有 UseTransaction 参数。 此参数包含活动事务中的命令。 您可以使用完整的参数名称或其别名 “usetx”。
仅当会话包含活动事务时才能使用该参数。 如果在没有活动事务的情况下输入带有 UseTransaction 参数的命令，则命令将失败。
若要查找带有 UseTransaction 参数的 cmdlet，请键入：
get-help * -parameter UseTransaction
在 PowerShell Core 中，所有旨在与 PowerShell 提供程序一起使用的 cmdlet 都支持事务。 因此，可以使用提供程序 cmdlet 来管理事务。
有关 PowerShell 提供程序的详细信息，请参阅 about_Providers。
TRANSACTION 对象
事务在 PowerShell 中由事务对象 System.Management.Automation.Transaction 表示。
对象具有以下属性：
RollbackPreference：包含为当前事务设置的回滚首选项。 您可以在使用 Start-Transaction 启动事务时设置 rollback 首选项。
回滚首选项确定事务自动回滚的条件。 有效值为 Error、TerminatingError 和 Never。 默认值为 Error。
Status：包含事务的当前状态。 有效值为 Active、Committed 和 RolledBack。
SubscriberCount：包含事务的订阅者数。 如果在另一个事务正在进行时启动另一个事务时，就会将订阅者添加到事务。 当订阅者提交事务时，订阅者计数会减少。
活动事务
在 PowerShell 中，一次只有一个事务处于活动状态，并且你只能管理活动事务。 在同一会话中可以同时进行多个事务，但只有最近启动的事务处于活动状态。
因此，在使用事务 cmdlet 时，无法指定特定事务。 命令始终适用于活动事务。
这在 Get-Transaction cmdlet 的行为中最为明显。 当您输入 Get-Transaction 命令时，Get-Transaction 始终只获得一个事务对象。 该对象是代表活动事务的对象。
若要管理其他事务，必须首先通过提交或回滚来完成活动事务。 执行此操作时，之前的事务会自动激活。 事务以与它们启动的顺序相反的顺序变为活动状态，因此最近启动的事务始终处于活动状态。
订阅者和独立交易
如果您在另一个事务正在进行时启动事务，则默认情况下，PowerShell 不会启动新事务。 在这种情况下，它会向当前事务添加一个“订阅者”。
当事务具有多个订阅者时，单个 Undo-Transaction 命令在任何时间点都会回滚所有订阅者的整个事务。 但是，要提交事务，必须为每个订阅者输入 Complete-Transaction 命令。
若要查找事务的订阅者数量，请检查事务对象的 SubscriberCount 属性。 例如，以下命令使用 Get-Transaction cmdlet 获取活动事务的 SubscriberCount 属性的值：
(Get-Transaction).SubscriberCount
添加订阅者是默认行为，因为在另一个事务正在进行时启动的大多数事务都与原始事务相关。 在典型模型中，包含事务的脚本将调用包含其自身事务的帮助器脚本。 由于事务是相关的，因此应将其作为一个单元回滚或提交。
但是，您可以使用 Start-Transaction cmdlet 的 Independent 参数启动独立于当前事务的事务。
当您启动独立事务时，Start-Transaction 会创建一个新的事务对象，并且新事务将成为活动事务。 可以提交或回滚独立事务，而不影响原始事务。
当独立事务完成（提交或回滚）时，原始事务再次变为活动事务。
更改数据
当您使用事务更改数据时，受事务影响的数据在您提交事务之前不会更改。 但是，相同的数据可以通过不属于事务的命令进行更改。
使用事务管理共享数据时，请记住这一点。 通常，数据库具有在处理数据时锁定数据的机制，以防止其他用户以及其他命令、脚本和函数更改数据。
但是，锁定是数据库的一项功能。 它与交易无关。 如果你正在支持事务的文件系统或其他数据存储中工作，则可以在事务处理过程中更改数据。
例子
本部分的示例使用 PowerShell 注册表提供程序并假设你熟悉该提供程序。 有关 Registry 提供程序的信息，请键入 “get-help registry”。
示例 1：提交事务
若要创建事务，请使用 Start-Transaction cmdlet。 以下命令使用默认设置启动事务。
start-transaction
若要在事务中包含命令，请使用 cmdlet 的 UseTransaction 参数。 默认情况下，命令不包含在事务中，
例如，以下命令（用于设置 HKCU： 驱动器的 Software 密钥中的当前位置）不包括在事务中。
cd hkcu:\Software
以下命令创建 MyCompany 密钥，它使用 New-Item cmdlet 的 UseTransaction 参数将命令包含在活动事务中。
new-item MyCompany -UseTransaction
该命令返回一个表示新密钥的对象，但由于该命令是事务的一部分，因此注册表尚未更改。
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
0 0 MyCompany {}
若要提交事务，请使用 Complete-Transaction cmdlet。 因为它总是影响活动事务，所以不能指定事务。
complete-transaction
因此，MyCompany 密钥将添加到注册表中。
dir m*
Hive: HKEY_CURRENT_USER\software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(default)}
0 0 MyCompany {}
示例 2：回滚事务
若要创建事务，请使用 Start-Transaction cmdlet。 以下命令使用默认设置启动事务。
start-transaction
以下命令创建 MyOtherCompany 密钥，它使用 New-Item cmdlet 的 UseTransaction 参数将命令包含在活动事务中。
new-item MyOtherCompany -UseTransaction
该命令返回一个表示新密钥的对象，但由于该命令是事务的一部分，因此注册表尚未更改。
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
0 0 MyOtherCompany {}
若要回滚事务，请使用 Undo-Transaction cmdlet。 因为它总是影响活动事务，所以您不需要指定事务。
Undo-transaction
结果是 MyOtherCompany 键未添加到注册表中。
dir m*
Hive: HKEY_CURRENT_USER\software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(default)}
0 0 MyCompany {}
示例 3：预览事务
通常，事务中使用的命令会更改数据。 但是，获取数据的命令在事务中也很有用，因为它们在事务内部获取数据。 这提供了提交事务会导致的更改的预览。
以下示例显示如何使用 Get-ChildItem 命令（别名为 “dir”）预览事务中的更改。
以下命令启动事务。
start-transaction
以下命令使用 New-ItemProperty cmdlet 将 MyKey 注册表项添加到 MyCompany 注册表项。 该命令使用 UseTransaction 参数在事务中包含命令。
new-itemproperty -path MyCompany -Name MyKey -value 123 -UseTransaction
该命令返回一个表示新注册表项的对象，但注册表项不会更改。
MyKey
-----
123
若要获取注册表中当前存在的项，请使用不带 UseTransaction 参数的 Get-ChildItem 命令 （“dir”）。 以下命令获取以“M”开头的项。
dir m*
结果显示尚未向 MyCompany 键添加任何条目。
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(default)}
0 0 MyCompany {}
要预览提交事务的效果，请输入带有 UseTransaction 参数的 Get-ChildItem （“dir”） 命令。 该命令提供事务中数据的视图。
dir m* -useTransaction
结果显示，如果提交了事务，则 MyKey 条目将添加到 MyCompany 密钥中。
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(default)}
0 1 MyCompany {MyKey}
示例 4：组合 TRANSACTED 和 NON-TRANSACTED 命令
可以在事务期间输入非事务命令。 non-transacted 命令会立即影响数据，但不会影响事务。 以下命令在 HKCU：\Software 注册表项中启动事务。
start-transaction
接下来的三个命令使用 New-Item cmdlet 将密钥添加到注册表。 第一个和第三个命令使用 UseTransaction 参数将命令包含在事务中。 第二个命令省略了参数。 由于第二个命令不包含在事务中，因此它立即生效。
new-item MyCompany1 -UseTransaction
new-item MyCompany2
new-item MyCompany3 -UseTransaction
要查看注册表的当前状态，请使用不带 UseTransaction 参数的 Get-ChildItem （“dir”） 命令。 此命令获取以 “M” 开头的项目。
dir m*
结果显示 MyCompany2 键已添加到注册表中，但未添加作为交易一部分的 MyCompany1 和 MyCompany3 键。
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(default)}
0 0 MyCompany2 {}
以下命令提交事务。
complete-transaction
现在，作为事务一部分添加的项出现在注册表中。
dir m*
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(default)}
0 0 MyCompany1 {}
0 0 MyCompany2 {}
0 0 MyCompany3 {}
示例 5：使用自动回滚
当事务中的命令生成任何类型的错误时，事务将自动回滚。
此默认行为是为运行事务的脚本设计的。 脚本通常经过充分测试，并包含错误处理逻辑，因此错误不会发生，并且应该终止事务。
第一个命令在 HKCU：\Software 注册表项中启动一个事务。
start-transaction
以下命令使用 New-Item cmdlet 将 MyCompany 密钥添加到注册表中。 该命令使用 UseTransaction 参数（别名为“usetx”）将命令包含在事务中。
New-Item MyCompany -UseTX
由于 MyCompany 密钥已存在于注册表中，因此命令将失败，并且事务将回滚。
New-Item : A key at this path already exists
At line:1 char:9
+ new-item <<<< MyCompany -usetx
Get-Transaction 命令确认事务已回滚，并且 SubscriberCount 为 0。
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 0 RolledBack
示例 6：更改 ROLLBACK 首选项
如果您希望事务具有更高的错误容忍度，则可以使用 Start-Transaction 的 RollbackPreference 参数来更改首选项。
以下命令启动回滚首选项为 “Never” 的事务。
start-transaction -rollbackpreference Never
在这种情况下，当命令失败时，事务不会自动回滚。
New-Item MyCompany -UseTX
New-Item : A key at this path already exists
At line:1 char:9
+ new-item <<<< MyCompany -usetx
由于事务仍然处于活动状态，因此你可以重新提交命令作为事务的一部分。
New-Item MyOtherCompany -UseTX
示例 7：使用 USE-TRANSACTION CMDLET
使用 Use-Transaction cmdlet 可以针对启用事务的 Microsoft .NET Framework 对象执行直接脚本编写。 Use-Transaction 采用一个脚本块，该脚本块只能包含使用启用事务的 .NET Framework 对象的命令和表达式，例如 Microsoft.PowerShell.Commands.Management.TransactedString 类的实例。
以下命令启动事务。
start-transaction
下面的 New-Object 命令创建 TransactedString 类的实例，并将其保存在 $t 变量中。
$t = New-Object Microsoft.PowerShell.Commands.Management.TransactedString
以下命令使用 TransactedString 对象的 Append 方法将文本添加到字符串中。 由于该命令不是事务的一部分，因此更改将立即生效。
$t.append("Windows")
以下命令使用相同的 Append 方法来添加文本，但它将文本添加为事务的一部分。 该命令括在大括号中，并设置为 Use-Transaction 的 ScriptBlock 参数的值。 UseTransaction 参数 （UseTx） 是必需的。
use-transaction {$t.append(" PowerShell")} -usetx
若要在 $t 中查看事务处理字符串的当前内容，请使用 TransactedString 对象的 ToString 方法。
$t.tostring()
输出显示只有非事务处理更改才会生效。
Windows
若要在事务中查看 $t 中事务处理字符串的当前内容，请将表达式嵌入 Use-Transaction 命令中。
use-transaction {$s.tostring()} -usetx
输出显示事务视图。
PowerShell
以下命令提交事务。
complete-transaction
若要查看最终字符串：
$t.tostring()
PowerShell
示例 8：管理 MULTI-SUBSCRIBER 事务
当您在另一个事务正在进行时启动事务时，默认情况下，PowerShell 不会创建第二个事务。 在这种情况下，它会向当前事务添加一个订阅者。
此示例演示如何查看和管理多订阅者事务。
首先在 HKCU：\Software 键中启动事务。
start-transaction
以下命令使用 Get-Transaction 命令获取活动事务。
get-transaction
结果显示代表活动事务的对象。
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 1 Active
以下命令将 MyCompany 项添加到注册表中。 该命令使用 UseTransaction 参数在事务中包含命令。
new-item MyCompany -UseTransaction
以下命令使用 Start-Transaction 命令启动事务。 尽管此命令是在命令提示符下键入的，但在运行包含事务的脚本时，更可能发生这种情况。
start-transaction
Get-Transaction 命令显示事务对象上的订阅者计数已递增。 该值现在为 2。
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 2 Active
下一个命令使用 New-ItemProperty cmdlet 将 MyKey 注册表项添加到 MyCompany 注册表项。 它使用 UseTransaction 参数在事务中包含命令。
new-itemproperty -path MyCompany -name MyKey -UseTransaction
注册表中不存在 MyCompany 密钥，但此命令成功，因为这两个命令是同一事务的一部分。
以下命令提交事务。 如果回滚了事务，则所有订阅者的事务都会回滚。
complete-transaction
Get-Transaction 命令显示事务对象上的订阅者计数为 1，但 Status 的值仍为 Active （not Committed）。
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 1 Active
若要完成提交事务，请输入第二个 Complete-Transaction 命令。 要提交多订阅者事务，必须为每个 Start-Transaction 命令输入一个 Complete-Transaction 命令。
complete-transaction
另一个 Get-Transaction 命令显示事务已提交。
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 0 Committed
示例 9：管理独立事务
当您在另一个事务正在进行时启动事务时，您可以使用 Start-Transaction 的 Independent 参数使新事务独立于原始事务。
执行此作时，Start-Transaction 会创建一个新的事务对象，并使新事务成为活动事务。
首先在 HKCU：\Software 键中启动事务。
start-transaction
以下命令使用 Get-Transaction 命令获取活动事务。
get-transaction
结果显示代表活动事务的对象。
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 1 Active
以下命令将 MyCompany 注册表项添加为事务的一部分。 它使用 UseTransaction 参数 （UseTx） 将命令包含在活动事务中。
new-item MyCompany -use
以下命令启动新事务。 该命令使用 Independent 参数来指示此事务不是活动事务的订户。
start-transaction -independent
创建独立事务时，新的（最近创建的）事务将变成活动事务。 您可以使用 Get-Transaction 命令来获取活动事务。
get-transaction
请注意，该事务的 SubscriberCount 为 1（表示没有其他订阅者），并且该事务是新的。
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 1 Active
必须先完成新事务（提交或回滚），然后才能管理原始事务。
以下命令将 MyOtherCompany 项添加到注册表中。 它使用 UseTransaction 参数 （UseTx） 将命令包含在活动事务中。
new-item MyOtherCompany -usetx
现在回滚事务。 如果单个事务有两个订阅者，则回滚该事务会回滚所有订阅者的整个事务。
但是，由于这些事务是独立的，回滚最新事务会取消注册表更改，并使原始事务变成活动事务。
undo-transaction
Get-Transaction 命令确认原始事务在会话中仍处于活动状态。
get-transaction
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 1 Active
以下命令提交活动事务。
complete-transaction
Get-ChildItem 命令显示注册表已更改。
dir m*
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(default)}
0 0 MyCompany {}