Use-Transaction

Use-Transaction コマンドレットは、アクティブなトランザクションにスクリプト ブロックを追加します。 これにより、トランザクションが有効な Microsoft .NET Framework オブジェクトを使用して、トランザクション スクリプトを実行できます。 スクリプト ブロックには、Microsoft.PowerShell.Commands.Management.TransactedString クラスのインスタンスなど、トランザクションが有効な .NET Framework オブジェクトのみを含めることができます。

このコマンドレットを使用する場合は、UseTransaction パラメーター (ほとんどのコマンドレットでは省略可能) が必要です。

Use-Transaction は、Windows PowerShell のトランザクション機能をサポートするコマンドレットのセットの 1 つです。 詳細については、「about_Transactions」を参照してください。

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

この例では、Use-Transaction を使用して、トランザクションが有効な .NET Framework オブジェクトに対してスクリプトを作成する方法を示します。 この場合、オブジェクトは TransactedString オブジェクト です。

最初のコマンドでは、Start-Transaction コマンドレットを使用してトランザクションを開始します。

2 番目のコマンドでは、New-Object コマンドを使用して、TransactedString オブジェクトを作成します。 $TransactedString変数にオブジェクトが格納されます。

3 番目と 4 番目のコマンドはどちらも、TransactedString オブジェクトの Append メソッドを使用して、$TransactedStringの値にテキストを追加します。 1 つのコマンドがトランザクションの一部です。 もう 1 つのコマンドは実行されません。

3 番目のコマンドでは、トランザクション文字列の Append メソッドを使用して、hello を $TransactedString の値に追加します。 コマンドはトランザクションの一部ではないため、変更はすぐに適用されます。

4 番目のコマンドでは、use-Transaction を使用して、トランザクション内の文字列にテキストを追加します。 このコマンドでは、Append メソッドを使用して、$TransactedStringの値に ", World" を追加します。 コマンドは中かっこ ({}) で囲んでスクリプト ブロックにします。 このコマンドでは、UseTransaction パラメーターが必要です。

5 番目と 6 番目のコマンドでは、TransactedString オブジェクトの ToString メソッドを使用して、TransactedString の値を文字列として表示します。 ここでも、1 つのコマンドがトランザクションの一部です。 もう 1 つのトランザクションは実行されません。

5 番目のコマンドは、ToString メソッドを使用して、$TransactedString変数の現在の値を表示します。 トランザクションの一部ではないため、文字列の現在の状態のみが表示されます。

6 番目のコマンドでは、use-Transaction を使用して、トランザクションで同じコマンドを実行します。 コマンドはトランザクションの一部であるため、トランザクションの変更のプレビューと同様に、トランザクション内の文字列の現在の値が表示されます。

7 番目のコマンドでは、Complete-Transaction コマンドレットを使用してトランザクションをコミットします。

最後のコマンドでは、ToString メソッドを使用して、変数の結果の値を文字列として表示します。

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

この例では、Use-Transaction コマンドを含むトランザクション ロールバックする効果を示します。 トランザクション内のすべてのコマンドと同様に、トランザクションがロールバックされると、トランザクションの変更は破棄され、データは変更されません。

最初のコマンドでは、トランザクションの開始 を使用してトランザクションを開始します。

2 番目のコマンドでは、New-Object を使用して、TransactedString オブジェクトを作成します。 $TransactedString変数にオブジェクトが格納されます。

トランザクションの一部ではない 3 番目のコマンドでは、Append メソッドを使用して、$TransactedStringの値に "Hello" を追加します。

4 番目のコマンドでは、use-Transaction を使用して、トランザクションで Append メソッドを使用する別のコマンドを実行します。 このコマンドでは、Append メソッドを使用して、$TransactedStringの値に ", World" を追加します。

5 番目のコマンドでは、Undo-Transaction コマンドレットを使用してトランザクションをロールバックします。 その結果、トランザクションで実行されたすべてのコマンドが元に戻されます。

最後のコマンドでは、ToString メソッドを使用して、$TransactedStringの結果の値を文字列として表示します。 結果は、トランザクションの外部で行われた変更のみがオブジェクトに適用されたことを示しています。

None

このコマンドレットに入力をパイプすることはできません。

PSObject

このコマンドレットは、トランザクションの結果を返します。

• UseTransaction パラメーターには、アクティブなトランザクションにコマンドが含まれています。 Use-Transaction コマンドレットは常にトランザクションで使用されるため、このパラメーターは、Use-Transaction コマンドを有効にするために必要です。