トランザクションをサポートする方法

この例では、トランザクションのサポートをコマンドレットに追加する基本的なコード要素を示します。

重要

トランザクションを処理する方法の詳細Windows PowerShellトランザクションについて」を参照してください

トランザクションをサポートするには

  1. コマンドレット属性を宣言する場合は、コマンドレットがトランザクションをサポートする必要があります。 コマンドレットでトランザクションがサポートされている場合Windows PowerShell実行時に、 パラメーター UseTransaction がコマンドレットに追加されます。

    [Cmdlet(VerbsCommunications.Send, "GreetingTx",
            SupportsTransactions=true )]
    
  2. 入力処理メソッドの 1 つで、トランザクションが使用可能かどうかを判断 if するブロックを追加します。 ステートメントが if に解決された場合、このステートメント内のアクションは、現在の true トランザクションのコンテキスト内で実行できます。

    if (TransactionAvailable())
    {
      using (CurrentPSTransaction)
      {
        WriteObject("Hello " + name + "  from within a transaction.");
      }
    }
    

参照

Writing a Windows PowerShell Cmdlet (Windows PowerShell コマンドレットの記述)