about_Transactions
主題
about_Transactions
簡短描述
說明如何管理 Windows PowerShell 的交易作業。
完整描述
從 Windows PowerShell 2.0 開始，Windows PowerShell 可支援交易。此功能可讓您開始進行
交易、指出哪些命令為交易所屬，以及認可或復原交易。
關於交易
在 Windows PowerShell 中，交易是一組包含一個或多個以邏輯單元來管理的命令。交易
可以完成 (「認可」)，而這會變更受交易影響的資料。或者，交易可以完全取消 (「復
原」)，如此一來，交易就不會變更受影響的資料。
由於任一交易中的所有命令都會視為一個單元進行管理，因此，所有命令不是全部認可、
就是全部復原。
交易廣泛運用在資料處理中，最常見的是用於資料庫操作及財務交易。最壞的情況不是
一組命令全部失敗，而是部分命令成功、部分失敗，使系統停留在受損、錯誤或無法解譯
的難以修復狀態，這就是最常使用交易的時候。
交易 CMDLET
Windows PowerShell 隨附數個專為管理交易而設計的 Cmdlet。
Cmdlet 描述
-------------- ---------------------------------
Start-Transaction 啟動新交易。
Use-Transaction 將命令或運算式加入至交易。命令必須使用
具有交易功能的物件。
Undo-Transaction 復原交易，不讓交易變更任何資料。
Complete-Transaction 認可交易。受交易影響的資料會變更。
Get-Transaction 取得現用交易的相關資訊。
如需交易 Cmdlet 的清單，請輸入：
get-command *transaction
如需 cmdlet 的詳細資訊，請輸入：
get-help <Cmdlet 名稱> -detailed
例如：
get-help use-transaction -detailed
具有交易功能的元素
若要參與交易，Cmdlet 和提供者都必須支援交易。此功能內建於受交易影響的物件中。
在 Windows Vista 中，Windows PowerShell 登錄提供者支援交易。TransactedString 物件
(Microsoft.PowerShell.Commands.Management.TransactedString) 可搭配任何執行
Windows PowerShell 的作業系統使用。
其他 Windows PowerShell 提供者可以支援交易。若要尋找您的工作階段中支援交易的
Windows PowerShell 提供者，請使用下列命令在提供者的 Capabilities 屬性中尋找
"Transactions" 值：
get-psprovider | where {$_.Capabilities -like "*transactions*"}
如需提供者的詳細資訊，請參閱提供者的說明。
若要取得提供者的說明，請輸入：
get-help <提供者名稱>
例如，若要取得登錄提供者的說明，請輸入：
get-help registry
USETRANSACTION 參數
可支援交易的 Cmdlet 都有 UseTransaction 參數。此參數包含現用交易的命令。您可以
使用完整的參數名稱或其別名 "usetx"。
此參數只能在工作階段包含現用交易時使用。如果您在沒有現用交易時輸入含有
UseTransaction 參數的命令，則命令會失敗。
若要尋找含有 UseTransaction 參數的 Cmdlet，請輸入：
get-help * -parameter UseTransaction
在 Windows PowerShell 核心中，所有專為搭配 Windows PowerShell 提供者使用的 Cmdlet
都支援交易。因此，您可以使用提供者 Cmdlet 來管理交易。
如需 Windows PowerShell 提供者的詳細資訊，請參閱 about_Providers。
交易物件
在 Windows PowerShell 中，交易是以交易物件 System.Management.Automation.Tra
nsaction 表示。
此物件具有下列屬性：
RollbackPreference：
包含目前交易的復原喜好設定。您可以在使用 Start-Transaction 啟動交易
時，設定復原喜好設定。
復原喜好設定會決定自動復原交易的條件。有效的值包括 Error、TerminatingError 和
Never。預設值為 Error。
Status：
包含交易目前的狀態。有效的值包括 Active、Committed 和 RolledBack。
SubscriberCount：
包含交易訂閱者的數目。若您啟動交易時已有其他交易正在進行，訂閱者就會加入交
易中。當訂閱者認可交易時，訂閱者計數便會遞減。
現用交易
在 Windows PowerShell 中，一次只有一項現用交易，而且您只能管理現用交易。同一工
作階段中可以同時有多項交易正在進行，但是只有最後啟動的交易為現用交易。
因此，使用交易 Cmdlet 時，您無法指定特殊交易。命令一律會套用至現用交易。
這種情形在 Get-Transaction Cmdlet 的行為中最為顯著。當您輸入
Get-Transaction 命令時，Get-Transaction 永遠只會取得一個交易物件。此物
件是代表現用交易的物件。
若要管理不同的交易，您必須先透過認可或復原的方式完成現用交易。當您完成交易時，
上一個交易會自動變成現用交易。交易會依照啟動的反向順序變成現用狀態，因此，最
後啟動的交易永遠是現用交易。
訂閱者和獨立交易
如果您在其他交易正在進行時啟動交易，Windows PowerShell 預設不會啟動新交易，而
會將「訂閱者」新增至目前交易。
當交易包含多個訂閱者時，任何時候的單一 Undo-Transaction 命令都會為所有訂閱
者復原整個交易。不過，若要認可交易，您必須為每一個訂閱者輸入
Complete-Transaction 命令。
若要尋找交易的訂閱者數目，請查看交易物件的 SubscriberCount 屬性。例如，下列命令
會使用 Get-Transaction Cmdlet 取得現用交易的 SubscriberCount 屬性值：
(Get-Transaction).SubscriberCount
新增訂閱者是預設行為，因為在其他交易進行中時啟動的大部分交易都與原始交易相關。
在典型模型中，包含交易的指令碼會呼叫包含本身交易的協助程式指令碼。由於交易之
間彼此相關，因此應該視為一個單元加以復原或認可。
不過，您可以使用 Start-Transaction Cmdlet 的 Independent 參數啟動與目前交易不
相關的交易。
當您啟動獨立交易時，Start-Transaction 會建立新的交易物件，而新交易會變成現
用交易。您可以認可或復原獨立交易，而不會影響原始交易。
獨立交易完成時 (已認可或復原)，原始交易會再次變為現用交易。
變更資料
當您使用交易變更資料時，受交易影響的資料會在您認可交易之後才變更。
不過，相同的資料可以透過不屬於交易的命令來變更。
當您使用交易來管理共用資料時，請記住這點。一般而言，資料庫具有一種機制，可在
您使用資料時鎖定資料，防止其他使用者以及其他命令、指令碼和函數變更資料。
不過，鎖定是資料庫的功能，與交易無關。如果您在啟用交易的檔案系統或其他資料存
放區工作，則資料可以在交易進行時變更。
範例
本節中的範例使用 Windows PowerShell 登錄提供者，並且假設您已熟悉其使用方式。如需
登錄提供者的詳細資訊，請輸入 "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。
由於此 Cmdlet 一定會影響現用交易，因此您無法指定交易。
complete-transaction
所以 MyCompany 機碼會新增至登錄。
dir m*
Hive: HKEY_CURRENT_USER\software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(預設)}
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。
由於此 Cmdlet 一定會影響現用交易，因此您無法指定交易。
Undo-transaction
結果是 MyOtherCompany 機碼不會新增至登錄。
dir m*
Hive: HKEY_CURRENT_USER\software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(預設)}
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
若要取得目前在登錄中的項目，請使用 Get-ChildItem 命令 ("dir")，但不加上
UseTransaction 參數。下列命令會取得開頭為 "M" 的項目。
dir m*
結果顯示，MyCompany 機碼中尚未加入任何項目。
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(預設)}
0 0 MyCompany {}
若要預覽認可交易的效果，請輸入 Get-ChildItem ("dir") 命令與 UseTransaction 參數。
此命令可從交易內提供資料的檢視。
dir m* -useTransaction
結果顯示，如果交易已認可，MyKey 項目將會新增至 MyCompany 機碼。
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(預設)}
0 1 MyCompany {MyKey}
範例 4：結合交易和非交易命令
您可以在交易期間輸入非交易命令。非交易命令會立即影響資料，但是不會影響交易。
下列命令會在 HKCU:\Software 登錄機碼中啟動交易。
start-transaction
下面三個命令會使用 New-Item Cmdlet 將機碼新增至登錄。第一個和第三個命令使用
UseTransaction 參數將命令加入交易中。第二個命令則會省略此參數。因為第二個命令未
包含在交易中，所以會立即生效。
new-item MyCompany1 -UseTransaction
new-item MyCompany2
new-item MyCompany3 -UseTransaction
若要檢視登錄的目前狀態，請使用 Get-ChildItem ("dir") 命令，但不加上 UseTransaction
參數。此命令會取得開頭為 "M" 的項目。
dir m*
結果顯示，MyCompany2 機碼會新增至登錄，屬於交易一部分的 MyCompany1 和
MyCompany3 機碼則不會加入。
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(預設)}
0 0 MyCompany2 {}
下列命令會認可交易。
complete-transaction
現在，已新增做為交易一部分的機碼會出現在登錄中。
dir m*
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(預設)}
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：此路徑的機碼已存在於第 1 行，第 9 個字元
+ new-item <<<< MyCompany -usetx
Get-Transaction 命令會確認交易已復原，且 SubscriberCount 為 0。
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 0 RolledBack
範例 6：變更復原喜好設定
如果您希望交易更能容錯，可以使用 Start-Transaction 的 RollbackPreference 參數變
更喜好設定。
下列命令會啟動交易，且復原喜好設定為 "Never"。
start-transaction -rollbackpreference Never
在此情況下，當命令失敗時，交易不會自動復原。
New-Item MyCompany -UseTX
New-Item：此路徑的機碼已存在於第 1 行，第 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
輸出結果會顯示交易檢視。
Windows PowerShell
下列命令會認可交易。
complete-transaction
若要查看最終一個字串：
$t.tostring()
Windows PowerShell
範例 7：管理多個訂閱者的交易
如果您在其他交易正在進行時啟動交易，Windows 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 (不是 Committed)。
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 1 Active
若要完成認可交易，請輸入另一個 Complete-Transaction 命令。若要認可包含多個訂閱者的
交易，則必須為每一個 Start-Transaction 命令輸入一個 Complete-Transaction
命令。
complete-transaction
另一個 Get-Transaction 命令顯示交易已認可。
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 0 Committed
範例 8：管理獨立交易
如果您在其他交易正在進行時啟動交易，可以使用 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 {(預設)}
0 0 MyCompany {}
請參閱
Start-Transaction
Get-Transaction
Complete-Transaction
Undo-Transaction
Use-Transaction
Registry (provider)
about_Providers
Get-PSProvider
Get-ChildItem