Obtiene la transacción actual (activa).

Sintaxis

Get-Transaction [<CommonParameters>]

Descripción

El cmdlet Get-Transaction obtiene un objeto que representa la transacción actual de la sesión.

Este cmdlet nunca devuelve más de un objeto, porque solamente hay una transacción activa a la vez. Si inicia una o más transacciones independientes (utilizando el parámetro Independent de Start-Transaction), la última transacción iniciada estará activa y esa es la transacción que Get-Transaction devuelve.

Cuando todas las transacciones activas se han revertido o confirmado, Get-Transaction muestra la última transacción activa en la sesión.

El cmdlet Get-Transaction es uno de un conjunto de cmdlets que admiten la característica de transacciones en Windows PowerShell. Para obtener más información, vea about_Transactions.

Parámetros

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

Ninguno

No puede canalizar objetos a este cmdlet.

Salidas

System.Management.Automation.PSTransaction

Get-Transaction devuelve un objeto que representa la transacción actual.

Ejemplo 1

C:\PS>start-transaction

C:\PS> get-transaction 

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

Descripción
-----------
Este comando utiliza el cmdlet Get-Transaction para obtener la transacción actual.






Ejemplo 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;}

Descripción
-----------
Este comando utiliza el cmdlet Get-Member para mostrar las propiedades y métodos del objeto de transacción.






Ejemplo 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

Descripción
-----------
Este comando muestra los valores de propiedad de un objeto de transacción para una transacción que se ha revertido.






Ejemplo 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

Descripción
-----------
Este comando muestra los valores de propiedad de un objeto de transacción para una transacción que se ha confirmado.






Ejemplo 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

Descripción
-----------
En este ejemplo se muestra el efecto en el objeto de transacción de iniciar una transacción mientras otra está en curso. Normalmente, esto sucede cuando un script que ejecuta una transacción incluye una función o llama a un script que contiene otra transacción completa.

A menos que el segundo comando Start-Transaction incluya el parámetro Independent, Start-Transaction no crea una nueva transacción. En su lugar, agrega un segundo suscriptor a la transacción original. 

El primer comando Start-Transaction inicia la transacción. Un comando New-Item con el parámetro UseTransaction forma parte de la transacción.

Un segundo comando Start-Transaction agrega un suscriptor a la transacción. El siguiente comando New-Item también forma parte de la transacción.

El primer comando Get-Transaction muestra la transacción con varios suscriptores. Observe que el recuento de suscriptores es 2.

El primer comando Complete-Transaction no confirma la transacción, pero reduce el recuento de suscriptores a 1.

El segundo comando Complete-Transaction confirma la transacción.






Ejemplo 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

Descripción
-----------
En este ejemplo se muestra el efecto en el objeto de transacción de iniciar una transacción independiente mientras otra está en curso.

El primer comando Start-Transaction inicia la transacción. Un comando New-Item con el parámetro UseTransaction forma parte de la transacción.

Un segundo comando Start-Transaction agrega un suscriptor a la transacción. El siguiente comando New-Item también forma parte de la transacción.

El primer comando Get-Transaction muestra la transacción con varios suscriptores. Observe que el recuento de suscriptores es 2.

El comando Complete-Transaction reduce el recuento de suscriptores a 1, pero no confirma la transacción.

El segundo comando Complete-Transaction confirma la transacción.






Vea también




Tabla de contenido