How to Support Transactions (Como Suportar Transações)

Este exemplo mostra os elementos de código básicos que adicionam suporte para transações a um cmdlet.

Importante

Para obter mais informações sobre como Windows PowerShell lida com transações, consulte Sobre Transações.

Para apoiar transações

1. Quando declarar o atributo Cmdlet, especifique que o cmdlet suporta transações. Quando o cmdlet suporta transações, Windows PowerShell adiciona o UseTransaction parâmetro ao cmdlet quando é executado.

   [Cmdlet(VerbsCommunications.Send, "GreetingTx",
           SupportsTransactions=true )]
   

2. Dentro de um dos métodos de processamento de entrada, adicione um if bloco para determinar se uma transação está disponível. Se a if declaração true decidir, as ações dentro desta declaração podem ser realizadas no âmbito da transação em curso.

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

Consulte também

Writing a Windows PowerShell Cmdlet (Escrever um Cmdlet do Windows PowerShell)