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