Undo-Transaction

Referencia

Módulo:: Microsoft.PowerShell.Management

Revierte la transacción activa.

Sintaxis

Undo-Transaction
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Undo-Transaction revierte la transacción activa. Al revertir una transacción, los cambios realizados por los comandos de la transacción se descartan y los datos se restauran en su forma original.

Si la transacción incluye varios suscriptores, un comando de Undo-Transaction revierte toda la transacción para todos los suscriptores.

De forma predeterminada, las transacciones se revierten automáticamente si algún comando de la transacción genera un error. Sin embargo, las transacciones se pueden iniciar mediante una preferencia de reversión diferente y puede usar este cmdlet para revertir la transacción activa en cualquier momento.

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

Ejemplos

Ejemplo 1: Revertir la transacción actual

Undo-Transaction

Este comando revierte la transacción actual, activa y .

Ejemplo 2: Iniciar y revertir una transacción

Set-Location HKCU:\software
Start-Transaction
New-Item -Path "ContosoCompany" -UseTransaction
Undo-Transaction

En este ejemplo se inicia una transacción y, a continuación, se revierte. Como resultado, no se realizan cambios en el registro.

Ejemplo 3: Revertir una transacción para todos los suscriptores

Set-Location HKCU:\software
Start-Transaction
New-Item -Path "ContosoCompany" -UseTransaction
Get-Transaction

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

Start-Transaction
Get-Transaction

RollbackPreference   SubscriberCount   Status
------------------   ---------------   -----
Error                2                 Active

Undo-Transaction
Get-Transaction

RollbackPreference   SubscriberCount   Status
------------------   ---------------   -----
Error                0                 RolledBack

En este ejemplo se muestra que cuando cualquier suscriptor revierte una transacción, toda la transacción se revierte para todos los suscriptores.

El primer comando cambia la ubicación a la clave del Registro HKCU:\Software.

El segundo comando inicia una transacción.

El tercer comando usa el cmdlet New-Item para crear una nueva clave del Registro. El comando usa el parámetro UseTransaction para incluir el cambio en la transacción.

El cuarto comando usa el cmdlet Get-Transaction para obtener la transacción activa. Observe que el estado es Activo y el número de suscriptores es 1.

El quinto comando usa de nuevo el comando Start-Transaction. Normalmente, iniciar una transacción mientras otra transacción está en curso se produce cuando un script usado por la transacción principal incluye su propia transacción completa. Este ejemplo se realiza de forma interactiva para que pueda examinarlo en fases. Al ejecutar un comando Start-Transaction mientras otra transacción está en curso, los comandos se unen a la transacción existente como un nuevo suscriptor y se incrementa el recuento de suscriptores.

El sexto comando usa el cmdlet Get-Transaction para obtener la transacción activa. Observe que el número de suscriptores es ahora 2.

El séptimo comando usa Undo-Transaction para revertir la transacción. Este comando no devuelve ningún objeto .

El comando final es un comando Get-Transaction que obtiene el activo o, en este caso, la transacción activa más recientemente. Los resultados muestran que la transacción se revierte y que el número de suscriptores es 0, lo que muestra que la transacción se revierte para todos los suscriptores.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

None

No se puede canalizar la entrada a este cmdlet.

Salidas