Complete-Transaction
提交活动事务。
语法
Complete-Transaction
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Complete-Transaction
cmdlet 提交活动事务。 在提交事务时,该事务中的命令将完成,并且受这些命令影响的数据将发生更改。
如果事务包括多个订阅者,则若要提交该事务,必须为每个Start-Transaction
命令都输入一条Complete-Transaction
命令。
Complete-Transaction
cmdlet 是 Windows PowerShell 中支持事务功能的一组 cmdlet 之一。
有关详细信息,请参阅 about_Transactions。
示例
示例 1:提交事务
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 {}
此示例演示了使用Complete-Transaction
cmdlet 提交事务时会发生什么情况。
Start-Transaction
命令启动事务。 New-Item 命令使用UseTransaction参数将该命令包括在事务中。
第一条Get-ChildItem
命令显示新项尚未添加到注册表中。
Complete-Transaction
命令将提交事务,这使注册表更改生效。 因而,第二条Get-ChildItem
命令显示注册表已更改。
示例 2:提交具有多个订阅者的事务
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}
此示例演示如何使用Complete-Transaction
提交拥有多个订阅者的事务。
要提交多订阅者事务,则必须为每个Start-Transaction
命令都输入一条Complete-Transaction
命令。 只有在提交最后一条Complete-Transaction
命令时才会更改数据。
出于演示目的,此示例演示了一系列在命令行中输入的命令。 实际上,事务很可能在脚本中运行,其中二级事务由主脚本调用的函数或助手脚本运行。
在此示例中,Start-Transaction
命令会启动事务。 带有UseTransaction参数的New-Item
命令将 MyCompany 项添加到 Software 项中。 虽然New-Item
cmdlet 返回项对象,但注册表中的数据尚未更改。
第二条Start-Transaction
命令将第二个订阅者添加到现有事务中。 Get-Transaction
cmdlet 确认订阅者计数为 2。 带有UseTransaction参数的 New-ItemProperty 命令将注册表项添加到新的 MyCompany 项中。 该命令再次返回一个值,但注册表未发生更改。
第一条Complete-Transaction
命令将订阅者计数减少 1 个。 Get-Transaction
命令确认了这一点。 但是,任何数据都未发生更改,如Get-ChildItem m*
命令显示。
第二条Complete-Transaction
命令提交整个事务并更改注册表中的数据。 可以通过显示更改的第二条Get-ChildItem m*
命令对此进行确认。
示例 3:执行不更改任何数据的事务
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
此示例演示在事务中使用 Get-* 命令以及不会更改数据的其他命令的值。 在事务中使用Get-\*
命令时,它将获取属于该事务的对象。 这样,在提交更改之前,可以预览事务中的更改。
在此示例中,将启动一个事务。 带有UseTransaction参数的 New-Item 命令向注册表中添加新项作为该事务的一部分。
因为新注册表项在运行Complete-Transaction
命令后才会添加到注册表中,所以简单的Get-ChildItem
命令将显示不包含新项的注册表。
然而,如果将UseTransaction参数添加到Get-ChildItem
命令中,则该命令将成为事务的一部分,并且它会获取该事务中的项,即使尚未将这些项添加到数据中也是如此。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
None
不能通过管道将对象传递给此 cmdlet。
输出
None
此 cmdlet 将不生成任何输出。
备注
无法回滚已提交的事务,或提交已回滚的事务。
不能回滚活动事务之外的任何事务。 若要回滚其他事务,必须首先提交或回滚活动事务。
默认情况下,如果无法提交事务的任何部分(例如,当事务中的某个命令产生错误时),则将回滚整个事务。