Undo-Transaction
Restaure la transaction active.
Syntaxe
Default (Par défaut)
Undo-Transaction
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Undo-Transaction restaure la transaction active. Lorsque vous restaurez une transaction, les modifications apportées par les commandes de la transaction sont ignorées et les données sont restaurées dans son formulaire d’origine.
Si la transaction inclut plusieurs abonnés, une commande Undo-Transaction restaure l’intégralité de la transaction pour tous les abonnés.
Par défaut, les transactions sont restaurées automatiquement si une commande de la transaction génère une erreur. Toutefois, les transactions peuvent être démarrées à l’aide d’une préférence de restauration différente et vous pouvez utiliser cette applet de commande pour restaurer la transaction active à tout moment.
L’applet de commande Undo-Transaction est l’un des ensembles d’applets de commande qui prennent en charge la fonctionnalité de transactions dans Windows PowerShell. Pour plus d’informations, consultez about_Transactions.
Exemples
Exemple 1 : Restaurer la transaction actuelle
Undo-Transaction
Cette commande restaure la transaction active, active et active.
Exemple 2 : Démarrer et restaurer une transaction
Set-Location HKCU:\software
Start-Transaction
New-Item -Path "ContosoCompany" -UseTransaction
Undo-Transaction
Cet exemple démarre une transaction, puis la restaure. Par conséquent, aucune modification n’est apportée au Registre.
Exemple 3 : Restaurer une transaction pour tous les abonnés
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
Cet exemple montre que lorsqu’un abonné annule une transaction, toute la transaction est restaurée pour tous les abonnés.
La première commande remplace l’emplacement par la clé de Registre HKCU:\Software.
La deuxième commande démarre une transaction.
La troisième commande utilise l’applet de commande New-Item pour créer une clé de Registre. La commande utilise le paramètre UseTransaction pour inclure la modification dans la transaction.
La quatrième commande utilise l’applet de commande Get-Transaction pour obtenir la transaction active. Notez que l’état est Actif et que le nombre d’abonnés est égal à 1.
La cinquième commande utilise à nouveau la commande Start-Transaction. En règle générale, le démarrage d’une transaction alors qu’une autre transaction est en cours se produit lorsqu’un script utilisé par la transaction principale inclut sa propre transaction complète. Cet exemple est effectué de manière interactive afin de pouvoir l’examiner en phases. Lorsque vous exécutez une commande Start-Transaction pendant qu’une autre transaction est en cours, les commandes rejoignent la transaction existante en tant que nouvel abonné et le nombre d’abonnés est incrémenté.
La sixième commande utilise l’applet de commande Get-Transaction pour obtenir la transaction active. Notez que le nombre d’abonnés est maintenant 2.
La septième commande utilise Undo-Transaction pour restaurer la transaction. Cette commande ne retourne aucun objet.
La commande finale est une commande Get-Transaction qui obtient l’actif ou, dans ce cas, la dernière transaction active. Les résultats indiquent que la transaction est restaurée et que le nombre d’abonnés est 0, indiquant que la transaction a été restaurée pour tous les abonnés.
Paramètres
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
None
Vous ne pouvez pas diriger l’entrée vers cette applet de commande.
Sorties
None
Cette applet de commande ne retourne aucune sortie.
Notes
Vous ne pouvez pas restaurer une transaction validée.
Vous ne pouvez pas restaurer une transaction autre que la transaction active. Pour restaurer une autre transaction indépendante, vous devez d’abord valider ou restaurer la transaction active.
La restauration de la transaction met fin à la transaction. Pour utiliser à nouveau une transaction, vous devez démarrer une nouvelle transaction.
