Obtém a transação (ativa) atual.
Sintaxe
Get-Transaction [<CommonParameters>]
Descrição
O cmdlet Get-Transaction obtém um objeto que representa a transação atual na sessão.
Este cmdlet nunca retorna mais do que um objeto, porque apenas uma transação fica ativa de cada vez. Se você iniciar uma ou mais transações independentes (usando o parâmetro Independent de Start-Transaction), a transação iniciada mais recentemente estará ativa e será ela que Get-Transaction retornará.
Quando todas as transações ativas estão revertidas ou confirmadas, Get-Transaction mostra a transação que era a transação ativa mais recente na sessão.
O cmdlet Get-Transaction faz parte de um conjunto de cmdlets que dão suporte ao recurso de transações no Windows PowerShell. Para obter mais informações, consulte about_Transactions.
Parâmetros
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
|
Entradas |
None Você não pode canalizar objetos para este cmdlet. |
|
Saídas |
System.Management.Automation.PSTransaction Get-Transaction retorna um objeto que representa a transação atual. |
Exemplo 1
C:\PS>start-transaction C:\PS> get-transaction RollbackPreference SubscriberCount Status ------------------ --------------- ------ Error 1 Active Descrição ----------- Esse comando usa o cmdlet Get-Transaction para obter a transação atual.
Exemplo 2
C:\PS>get-transaction | get-member
Name MemberType Definition
---- ---------- ----------
Dispose Method System.Void Dispose(), System.Void Dispose(Boolean disposing)
Equals Method System.Boolean Equals(Object obj)
GetHashCode Method System.Int32 GetHashCode()
GetType Method System.Type GetType()
ToString Method System.String ToString()
IsCommitted Property System.Boolean IsCommitted {get;}
IsRolledBack Property System.Boolean IsRolledBack {get;}
RollbackPreference Property System.Management.Automation.RollbackSeverity RollbackPreference {get;}
SubscriberCount Property System.Int32 SubscriberCount {get;set;}
Descrição
-----------
Esse comando usa o cmdlet Get-Member para mostrar as propriedades e os métodos do objeto de transação.
Exemplo 3
C:\PS>cd hklm:\software HKLM:\SOFTWARE> Start-Transaction HKLM:\SOFTWARE> New-Item MyCompany -UseTransaction HKLM:\SOFTWARE> Undo-Transaction HKLM:\SOFTWARE> Get-Transaction RollbackPreference SubscriberCount Status ------------------ --------------- ---------- Error 0 RolledBack Descrição ----------- Esse comando mostra os valores de propriedade de um objeto de transação para uma transação revertida.
Exemplo 4
C:\PS>cd hklm:\software HKLM:\SOFTWARE> Start-Transaction HKLM:\SOFTWARE> New-Item MyCompany -UseTransaction HKLM:\SOFTWARE> Complete-Transaction HKLM:\SOFTWARE> Get-Transaction RollbackPreference SubscriberCount Status ------------------ --------------- --------- Error 1 Committed Descrição ----------- Esse comando mostra os valores de propriedade de um objeto de transação para uma transação confirmada.
Exemplo 5
C:\PS>cd hklm:\software HKLM:\SOFTWARE> Start-Transaction HKLM:\SOFTWARE> New-Item MyCompany -UseTransaction HKLM:\SOFTWARE> Start-Transaction HKLM:\SOFTWARE> New-Item MyCompany2 -UseTransaction HKLM:\SOFTWARE> Get-Transaction RollbackPreference SubscriberCount Status ------------------ --------------- ------ Error 2 Active HKLM:\SOFTWARE> Complete-Transaction HKLM:\SOFTWARE> Get-Transaction RollbackPreference SubscriberCount Status ------------------ --------------- ------ Error 1 Active HKLM:\SOFTWARE> Complete-Transaction HKLM:\SOFTWARE> Get-Transaction RollbackPreference SubscriberCount Status ------------------ --------------- --------- Error 1 Committed Descrição ----------- Este exemplo mostra o efeito no objeto de transação de iniciar uma transação enquanto outra transação está em andamento. Normalmente, isso acontece quando um script que executa uma transação inclui uma função ou chama um script que contém outra transação completa. A menos que o segundo comando Start-Transaction inclua o parâmetro Independent, Start-Transaction não cria uma nova transação. Em vez disso, ele adiciona um segundo assinante à transação original. O primeiro comando Start-Transaction inicia a transação. Um comando New-Item com o parâmetro UseTransaction faz parte da transação. Um segundo comando Start-Transaction adiciona um assinante à transação. O próximo comando New-Item também faz parte da transação. O primeiro Get-Transaction comando mostra a transação de vários assinantes. Observe que a contagem de assinantes é 2. O primeiro comando Complete-Transaction não confirma a transação, mas reduz a contagem de assinantes a 1. O segundo comando Complete-Transaction confirma a transação.
Exemplo 6
C:\PS>HKLM:\SOFTWARE> Start-Transaction HKLM:\SOFTWARE> Get-Transaction RollbackPreference SubscriberCount IsRolledBack IsCommitted ------------------ --------------- ------------ ----------- Error 1 False False HKLM:\SOFTWARE> Start-Transaction -Independent HKLM:\SOFTWARE> Get-Transaction RollbackPreference SubscriberCount IsRolledBack IsCommitted ------------------ --------------- ------------ ----------- Error 1 False False HKLM:\SOFTWARE> Complete-Transaction HKLM:\SOFTWARE> Get-Transaction HKLM:\SOFTWARE> Complete-Transaction HKLM:\SOFTWARE> Get-Transaction Descrição ----------- Este exemplo mostra o efeito no objeto de transação de iniciar uma transação independente enquanto outra transação está em andamento. O primeiro comando Start-Transaction inicia a transação. Um comando New-Item com o parâmetro UseTransaction faz parte da transação. Um segundo comando Start-Transaction adiciona um assinante à transação. O próximo comando New-Item também faz parte da transação. O primeiro Get-Transaction comando mostra a transação de vários assinantes. Observe que a contagem de assinantes é 2. O comando Complete-Transaction reduz a contagem de assinantes a 1, mas não confirma a transação. O segundo comando Complete-Transaction confirma a transação.
See Also