about_Transactions

發行項
03/19/2024

簡短描述

描述如何在PowerShell中管理交易作業。

詳細描述

PowerShell 從 PowerShell 2.0 開始支援交易。這項功能可讓您啟動交易、指出哪些命令是交易的一部分，以及認可或回復交易。

關於交易

在 PowerShell 中，交易是一組一或多個以邏輯單元方式管理的命令。交易可以完成（“committed”），這會變更受交易影響的數據。或者，交易可以完全復原（「回復」），讓受影響的數據不會由交易變更。

由於交易中的命令會以單位方式管理，因此會認可所有命令，或復原所有命令。

交易在數據處理中廣泛使用，尤其是資料庫作業和財務交易。交易最常用於一組命令最壞的情況不是它們全都失敗，而是有些命令成功，而其他命令失敗，使系統處於難以修復的損毀、false 或無法解譯的狀態。

TRANSACTION CMDLET

PowerShell 包含數個專為管理交易而設計的 Cmdlet。

開始交易：啟動新的交易。
Use-Transaction：將命令或表達式新增至交易。命令必須使用啟用交易的物件。
復原交易：復原交易，讓交易不會變更任何數據。
完整交易：認可交易。交易影響的數據會變更。
Get-Transaction：取得使用中交易的相關信息。

如需交易 Cmdlet 的清單，請輸入：

get-command *transaction

如需 Cmdlet 的詳細資訊，請輸入：

get-help use-transaction -detailed

交易啟用的元素

若要參與交易，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>

例如，若要取得登錄提供者的說明，請輸入：

get-help registry

USETRANSACTION 參數

可支援交易的 Cmdlet 具有 UseTransaction 參數。此參數會在使用中交易中包含命令。您可以使用完整參數名稱或其別名「usetx」。

只有在會話包含使用中交易時，才能使用參數。如果您在沒有使用中交易時，使用UseTransaction 參數輸入命令，則命令會失敗。

若要使用UseTransaction 參數尋找 Cmdlet，請輸入：

get-help * -parameter UseTransaction

在 PowerShell 核心中，所有設計來與 PowerShell 提供者搭配運作的 Cmdlet 都支援交易。因此，您可以使用提供者 Cmdlet 來管理交易。

如需 PowerShell 提供者的詳細資訊，請參閱 about_Providers。

TRANSACTION 物件

交易是以交易物件 System.Management.Automation.Transaction 表示在 PowerShell 中。

物件具有下列屬性：

RollbackPreference：包含目前交易的回復喜好設定。您可以使用開始交易來啟動交易時，設定復原喜好設定。

回復喜好設定會決定自動回復交易的條件。有效值為 Error、TerminatingError 和 Never。預設值為 Error。
狀態：包含交易的目前狀態。有效值為 Active、Committed 和 RolledBack。
SubscriberCount：包含交易的訂閱者數目。當您在另一筆交易進行時啟動交易時，就會將訂閱者新增至交易。訂閱者認可交易時，訂閱者計數會遞減。

使用中交易

在 PowerShell 中，一次只有一個交易作用中，而且您只能管理作用中的交易。同一個會話中可以同時進行多個交易，但只有最近啟動的交易處於作用中狀態。

因此，您無法在使用交易 Cmdlet 時指定特定交易。命令一律會套用至使用中的交易。

這在 Get-Transaction Cmdlet 的行為中最為明顯。當您輸入 Get-Transaction 命令時，Get-Transaction 一律只會取得一個交易物件。這個物件是代表使用中交易的物件。

若要管理不同的交易，您必須先認可或回復使用中交易，才能完成作用中交易。當您這樣做時，先前的交易會自動變成作用中。交易會依啟動的順序變成作用中，讓最近啟動的交易一律為作用中。

訂閱者和獨立交易

如果您在另一個交易進行中時啟動交易，根據預設，PowerShell 不會啟動新的交易。相反地，它會將「訂閱者」新增至目前的交易。

當交易有多個訂閱者時，任何時間點的單一復原交易命令都會回復所有訂閱者的整個交易。不過，若要認可交易，您必須為每個訂閱者輸入 Complete-Transaction 命令。

若要尋找交易的訂閱者數目，請檢查交易物件的 SubscriberCount 屬性。例如，下列命令會使用 Get-Transaction Cmdlet 來取得使用中交易的 SubscriberCount 屬性值：

(Get-Transaction).SubscriberCount

新增訂閱者是預設行為，因為當另一個交易進行時啟動的大部分交易都與原始交易相關。在一般模型中，包含交易的腳本會呼叫包含其本身交易的協助程式腳本。由於交易相關，因此應該以單位的形式回復或認可它們。

不過，您可以使用 Start-Transaction Cmdlet 的 Independent 參數，啟動與目前交易無關的交易。

當您啟動獨立交易時，Start-Transaction 會建立新的交易物件，而新的交易會變成使用中的交易。獨立交易可以認可或回復，而不會影響原始交易。

當獨立交易完成時（已認可或回復），原始交易會再次變成使用中交易。

變更數據

當您使用交易來變更數據時，在您認可交易之前，不會變更受交易影響的數據。不過，不屬於交易一部分的命令可以變更相同的數據。

當您使用交易來管理共享數據時，請記住這點。一般而言，資料庫具有在處理數據時鎖定數據的機制，以防止其他使用者和其他命令、腳本和函式變更數據。

不過，鎖定是資料庫的一項功能。這與交易無關。如果您正在交易啟用的檔案系統或其他數據存放區中工作，則在交易進行時可以變更數據。

範例

本節中的範例會使用 PowerShell 登錄提供者，並假設您已熟悉它。如需登錄提供者的相關信息，請輸入「get-help registry」。。

範例 1：認可交易

若要建立交易，請使用 Start-Transaction Cmdlet。下列命令會使用預設設定啟動交易。

start-transaction

若要在交易中包含命令，請使用 Cmdlet 的 UseTransaction 參數。根據預設，命令不會包含在交易中，

例如，下列命令會設定 HKCU：磁碟驅動器軟體密鑰中的目前位置，不會包含在交易中。

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 和非交易命令

您可以在交易期間輸入非交易的命令。非交易的命令會立即影響數據，但不會影響交易。下列命令會在 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：變更復原喜好設定

如果您想要讓交易更容錯，您可以使用 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：管理多訂閱者交易

當您在另一筆交易進行時啟動交易時，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 的值仍為作用中（未認可）。

RollbackPreference   SubscriberCount   Status
------------------   ---------------   ------
Error                1                 Active

若要完成認可交易，請輸入第二個完成交易命令。若要認可多訂閱者交易，您必須為每個 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                      {}