about_Transactions
Description courte
Décrit comment gérer les opérations traitées dans PowerShell.
Description longue
Les transactions sont prises en charge dans PowerShell à partir de PowerShell 2.0. Cette fonctionnalité vous permet de démarrer une transaction, d’indiquer quelles commandes font partie de la transaction et de valider ou restaurer une transaction.
Dans PowerShell, une transaction est un ensemble d’une ou plusieurs commandes gérées en tant qu’unité logique. Une transaction peut être terminée (« validée »), ce qui modifie les données affectées par la transaction. Ou bien, une transaction peut être entièrement annulée (« restaurée ») afin que les données affectées ne soient pas modifiées par la transaction.
Étant donné que les commandes d’une transaction sont gérées en tant qu’unité, toutes les commandes sont validées ou toutes les commandes sont restaurées.
Les transactions sont largement utilisées dans le traitement des données, notamment dans les opérations de base de données et pour les transactions financières. Les transactions sont le plus souvent utilisées lorsque le pire scénario pour un ensemble de commandes n’est pas qu’ils échouent tous, mais que certaines commandes réussissent alors que d’autres échouent, laissant le système dans un état endommagé, faux ou ininterpretable qui est difficile à réparer.
Applets de commande de transaction
PowerShell inclut plusieurs applets de commande conçues pour la gestion des transactions.
Start-Transaction: démarre une nouvelle transaction.Use-Transaction: ajoute une commande ou une expression à la transaction. La commande doit utiliser des objets compatibles avec les transactions.Undo-Transaction: restaure la transaction afin qu’aucune donnée ne soit modifiée par la transaction.Complete-Transaction: valide la transaction. Les données affectées par la transaction sont modifiées.Get-Transaction: obtient des informations sur la transaction active.
Pour obtenir la liste des applets de commande de transaction, tapez :
Get-Command *transaction
Pour plus d’informations sur les applets de commande, tapez :
Get-Help Use-Transaction -Detailed
Éléments compatibles avec les transactions
Pour participer à une transaction, l’applet de commande et le fournisseur doivent prendre en charge les transactions. Cette fonctionnalité est intégrée aux objets affectés par la transaction.
Le fournisseur de Registre PowerShell prend en charge les transactions dans Windows. L’objet TransactedString fonctionne avec n’importe quel système d’exploitation qui exécute PowerShell.
D’autres fournisseurs PowerShell peuvent prendre en charge les transactions. Pour rechercher les fournisseurs PowerShell dans votre session qui prennent en charge les transactions, utilisez la commande suivante pour rechercher la valeur transactions dans la propriété Fonctionnalités des fournisseurs :
Get-PSProvider | Where-Object {$_.Capabilities -like "*transactions*"}
Pour plus d’informations sur un fournisseur, consultez l’aide du fournisseur. Pour obtenir de l’aide du fournisseur, tapez :
Get-Help <provider-name>
Par exemple, pour obtenir de l’aide sur le fournisseur de Registre, tapez :
Get-Help registry
Paramètre UseTransaction
Les applets de commande qui peuvent prendre en charge les transactions ont un paramètre UseTransaction . Ce paramètre inclut la commande dans la transaction active. Vous pouvez utiliser le nom complet du paramètre ou son alias, usetx.
Le paramètre ne peut être utilisé que lorsque la session contient une transaction active. Si vous entrez une commande avec le paramètre UseTransaction lorsqu’il n’existe aucune transaction active, la commande échoue.
Pour rechercher des applets de commande avec le paramètre UseTransaction , tapez :
Get-Help * -Parameter UseTransaction
Dans PowerShell Core, toutes les applets de commande conçues pour fonctionner avec les fournisseurs PowerShell prennent en charge les transactions. Par conséquent, vous pouvez utiliser les applets de commande du fournisseur pour gérer les transactions.
Pour plus d’informations sur les fournisseurs PowerShell, consultez about_Providers.
Objet transactionnel
Les transactions sont représentées dans PowerShell par un objet transactionnel, System.Management.Automation.Transaction.
L’objet dispose des propriétés suivantes :
RollbackPreference : contient la préférence de restauration définie pour la transaction actuelle. Vous pouvez définir la préférence de restauration lorsque vous utilisez
Start-Transactionpour démarrer la transaction.La préférence de restauration détermine les conditions dans lesquelles la transaction est restaurée automatiquement. Les valeurs valides sont
Error,TerminatingErroretNever. La valeur par défaut estError.État : contient l’état actuel de la transaction. Les valeurs valides sont
Active,CommittedetRolledBack.SubscriberCount : contient le nombre d’abonnés à la transaction. Un abonné est ajouté à une transaction lorsque vous démarrez une transaction pendant qu’une autre transaction est en cours. Le nombre d’abonnés est décrémenté lorsqu’un abonné valide la transaction.
Transactions actives
Dans PowerShell, une seule transaction est active à la fois et vous pouvez gérer uniquement la transaction active. Plusieurs transactions peuvent être en cours dans la même session en même temps, mais seules les transactions démarrées le plus récemment sont actives.
Par conséquent, vous ne pouvez pas spécifier une transaction particulière lors de l’utilisation des applets de commande de transaction. Les commandes s’appliquent toujours à la transaction active.
Cela est le plus évident dans le comportement de l’applet Get-Transaction de commande. Lorsque vous entrez une Get-Transaction commande, Get-Transaction obtient toujours un seul objet de transaction. Cet objet est l’objet qui représente la transaction active.
Pour gérer une autre transaction, vous devez d’abord terminer la transaction active, soit en la commitant, soit en la réamettant. Lorsque vous effectuez cette opération, la transaction précédente devient active automatiquement. Les transactions deviennent actives dans l’ordre inverse de leur démarrage, afin que la transaction la plus récente soit toujours active.
Abonnés et transactions indépendantes
Si vous démarrez une transaction alors qu’une autre transaction est en cours, par défaut, PowerShell ne démarre pas une nouvelle transaction. Au lieu de cela, il ajoute un « abonné » à la transaction actuelle.
Lorsqu’une transaction a plusieurs abonnés, une seule Undo-Transaction commande à tout moment restaure l’intégralité de la transaction pour tous les abonnés.
Toutefois, pour valider la transaction, vous devez entrer une Complete-Transaction commande pour chaque abonné.
Pour rechercher le nombre d’abonnés à une transaction, vérifiez la propriété SubscriberCount de l’objet de transaction. Par exemple, la commande suivante utilise l’applet Get-Transaction de commande pour obtenir la valeur de la propriété SubscriberCount de la transaction active :
(Get-Transaction).SubscriberCount
L’ajout d’un abonné est le comportement par défaut, car la plupart des transactions démarrées pendant qu’une autre transaction est en cours sont liées à la transaction d’origine. Dans le modèle classique, un script qui contient une transaction appelle un script d’assistance qui contient sa propre transaction. Étant donné que les transactions sont liées, elles doivent être restaurées ou validées en tant qu’unité.
Toutefois, vous pouvez démarrer une transaction indépendante de la transaction actuelle à l’aide du paramètre Indépendant de l’applet Start-Transaction de commande.
Lorsque vous démarrez une transaction indépendante, Start-Transaction crée un objet transactionnel et la nouvelle transaction devient la transaction active. La transaction indépendante peut être validée ou restaurée sans affecter la transaction d’origine.
Lorsque la transaction indépendante est terminée (validée ou restaurée), la transaction d’origine devient à nouveau la transaction active.
Modification des données
Lorsque vous utilisez des transactions pour modifier des données, les données affectées par la transaction ne sont pas modifiées tant que vous n’avez pas validée la transaction. Toutefois, les mêmes données peuvent être modifiées par des commandes qui ne font pas partie de la transaction.
Gardez à l’esprit que lorsque vous utilisez des transactions pour gérer les données partagées. En règle générale, les bases de données ont des mécanismes qui verrouillent les données pendant que vous travaillez dessus, empêchent d’autres utilisateurs et d’autres commandes, scripts et fonctions, de les modifier.
Toutefois, le verrou est une fonctionnalité de la base de données. Elle n’est pas liée aux transactions. Si vous travaillez dans un système de fichiers compatible avec la transaction ou dans un autre magasin de données, les données peuvent être modifiées pendant que la transaction est en cours.
Exemples
Les exemples de cette section utilisent le fournisseur de Registre PowerShell et supposent que vous êtes familiarisé avec celui-ci. Pour plus d’informations sur le fournisseur de Registre, tapez Get-Help registry.
Exemple 1 : Validation d’une transaction
Pour créer une transaction, utilisez l’applet de Start-Transaction commande. La commande suivante démarre une transaction avec les paramètres par défaut.
Start-Transaction
Pour inclure des commandes dans la transaction, utilisez le paramètre UseTransaction de l’applet de commande. Par défaut, les commandes ne sont pas incluses dans la transaction,
Par exemple, la commande suivante, qui définit l’emplacement actuel dans la clé logicielle du HKCU: lecteur, n’est pas incluse dans la transaction.
cd hkcu:\Software
La commande suivante, qui crée la clé MyCompany, utilise le paramètre UseTransaction de l’applet New-Item de commande pour inclure la commande dans la transaction active.
New-Item MyCompany -UseTransaction
La commande retourne un objet qui représente la nouvelle clé, mais, étant donné que la commande fait partie de la transaction, le Registre n’est pas encore modifié.
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
0 0 MyCompany {}
Pour valider la transaction, utilisez l’applet de Complete-Transaction commande. Étant donné qu’elle affecte toujours la transaction active, vous ne pouvez pas spécifier la transaction.
Complete-Transaction
Par conséquent, la MyCompany clé est ajoutée au Registre.
dir m*
Hive: HKEY_CURRENT_USER\software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(default)}
0 0 MyCompany {}
Exemple 2 : Restauration d’une transaction
Pour créer une transaction, utilisez l’applet de Start-Transaction commande. La commande suivante démarre une transaction avec les paramètres par défaut.
Start-Transaction
La commande suivante, qui crée la clé MyOtherCompany, utilise le paramètre UseTransaction de l’applet New-Item de commande pour inclure la commande dans la transaction active.
New-Item MyOtherCompany -UseTransaction
La commande retourne un objet qui représente la nouvelle clé, mais, étant donné que la commande fait partie de la transaction, le Registre n’est pas encore modifié.
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
0 0 MyOtherCompany {}
Pour restaurer la transaction, utilisez l’applet de Undo-Transaction commande. Étant donné qu’elle affecte toujours la transaction active, vous ne spécifiez pas la transaction.
Undo-Transaction
Le résultat est que la MyOtherCompany clé n’est pas ajoutée au Registre.
dir m*
Hive: HKEY_CURRENT_USER\software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(default)}
0 0 MyCompany {}
Exemple 3 : aperçu d’une transaction
En règle générale, les commandes utilisées dans une transaction changent de données. Toutefois, les commandes qui obtiennent des données sont utiles dans une transaction, aussi, car elles obtiennent des données à l’intérieur de la transaction. Cela fournit un aperçu des modifications qui valident la transaction provoquerait.
L’exemple suivant montre comment utiliser la Get-ChildItem commande (l’alias est dir) pour afficher un aperçu des modifications apportées à une transaction.
La commande suivante démarre une transaction.
Start-Transaction
La commande suivante utilise l’applet New-ItemProperty de commande pour ajouter l’entrée de MyKey Registre à la clé MyCompany. La commande utilise le paramètre UseTransaction pour inclure la commande dans la transaction.
New-Itemproperty -path MyCompany -Name MyKey -value 123 -UseTransaction
La commande retourne un objet représentant la nouvelle entrée de Registre, mais l’entrée de Registre n’est pas modifiée.
MyKey
-----
123
Pour obtenir les éléments actuellement présents dans le Registre, utilisez une Get-ChildItem commande (dir) sans le paramètre UseTransaction. La commande suivante obtient les éléments qui commencent par « M ».
dir m*
Le résultat indique qu’aucune entrée n’a encore été ajoutée à la MyCompany clé.
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(default)}
0 0 MyCompany {}
Pour afficher un aperçu de l’effet de la validation de la transaction, entrez une Get-ChildItem commande (dir) avec le paramètre UseTransaction. Cette commande a une vue des données à partir de la transaction.
dir m* -useTransaction
Le résultat montre que, si la transaction est validée, l’entrée MyKey est ajoutée à la MyCompany clé.
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(default)}
0 1 MyCompany {MyKey}
Exemple 4 : combinaison de commandes traitées et non traitées
Vous pouvez entrer des commandes non traitées pendant une transaction. Les commandes non traitées affectent immédiatement les données, mais elles n’affectent pas la transaction.
La commande suivante démarre une transaction dans la clé de HKCU:\Software Registre.
Start-Transaction
Les trois commandes suivantes utilisent l’applet New-Item de commande pour ajouter des clés au Registre.
Les premières et troisième commandes utilisent le paramètre UseTransaction pour inclure les commandes dans la transaction. La deuxième commande omet le paramètre. Étant donné que la deuxième commande n’est pas incluse dans la transaction, elle est effective immédiatement.
New-Item MyCompany1 -UseTransaction
New-Item MyCompany2
New-Item MyCompany3 -UseTransaction
Pour afficher l’état actuel du Registre, utilisez une Get-ChildItem commande (dir) sans le paramètre UseTransaction. Cette commande obtient les éléments qui commencent par M.
dir m*
Le résultat montre que la MyCompany2 clé est ajoutée au Registre, mais que les MyCompany1 MyCompany3 clés et les clés qui font partie de la transaction ne sont pas ajoutées.
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(default)}
0 0 MyCompany2 {}
La commande suivante valide la transaction.
Complete-Transaction
À présent, les clés qui ont été ajoutées dans le cadre de la transaction apparaissent dans le Registre.
dir m*
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(default)}
0 0 MyCompany1 {}
0 0 MyCompany2 {}
0 0 MyCompany3 {}
Exemple 5 : Utilisation de la restauration automatique
Lorsqu’une commande dans une transaction génère une erreur de tout type, la transaction est automatiquement restaurée.
Ce comportement par défaut est conçu pour les scripts qui exécutent des transactions. Les scripts sont généralement bien testés et incluent une logique de gestion des erreurs. Par conséquent, les erreurs ne sont pas attendues et doivent arrêter la transaction.
La première commande démarre une transaction dans la clé de HKCU:\Software Registre.
Start-Transaction
La commande suivante utilise l’applet New-Item de commande pour ajouter la MyCompany clé au Registre. La commande utilise le paramètre UseTransaction (l’alias est usetx) pour inclure la commande dans la transaction.
New-Item MyCompany -usetx
Étant donné que la MyCompany clé existe déjà dans le Registre, la commande échoue et la transaction est restaurée.
New-Item : A key at this path already exists
At line:1 char:9
+ New-Item <<<< MyCompany -usetx
Une Get-Transaction commande confirme que la transaction a été restaurée et que l’AbonnéCount est 0.
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 0 RolledBack
Exemple 6 : Modification de la préférence de restauration
Si vous souhaitez que la transaction soit plus tolérante aux erreurs, vous pouvez utiliser le paramètre RollbackPreference pour Start-Transaction modifier la préférence.
La commande suivante démarre une transaction avec une préférence de restauration de Never.
Start-Transaction -RollbackPreference Never
Dans ce cas, lorsque la commande échoue, la transaction n’est pas restaurée automatiquement.
New-Item MyCompany -usetx
New-Item : A key at this path already exists
At line:1 char:9
+ New-Item <<<< MyCompany -usetx
Étant donné que la transaction est toujours active, vous pouvez renvoyer la commande dans le cadre de la transaction.
New-Item MyOtherCompany -usetx
Exemple 7 : Utilisation de l’applet de Use-Transaction commande
L’applet Use-Transaction de commande vous permet d’effectuer des scripts directs sur des objets Microsoft .NET Framework compatibles avec les transactions. Use-Transaction prend un bloc de script qui ne peut contenir que des commandes et des expressions qui utilisent des objets .NET Framework compatibles avec transaction, tels que des instances de la classe Microsoft.PowerShell.Commands.Management.TransactedString .
La commande suivante démarre une transaction.
Start-Transaction
La commande suivante New-Object crée une instance de la classe TransactedString et l’enregistre dans la $t variable.
$t = New-Object Microsoft.PowerShell.Commands.Management.TransactedString
La commande suivante utilise la méthode Append de l’objet TransactedString pour ajouter du texte à la chaîne. Étant donné que la commande ne fait pas partie de la transaction, la modification est effective immédiatement.
$t.append("Windows")
La commande suivante utilise la même méthode Append pour ajouter du texte, mais elle ajoute le texte dans le cadre de la transaction. La commande est placée entre accolades et elle est définie comme valeur du paramètre ScriptBlock de Use-Transaction. Le paramètre UseTransaction (usetx) est requis.
Use-Transaction {$t.append(" PowerShell")} -usetx
Pour afficher le contenu actuel de la chaîne transactionnelle dans $t, utilisez la ToString méthode de l’objet TransactedString .
$t.tostring()
La sortie indique que seules les modifications non traitées sont effectives.
Windows
Pour afficher le contenu actuel de la chaîne traitée dans $t à partir de la transaction, incorporez l’expression dans une Use-Transaction commande.
Use-Transaction {$t.tostring()} -usetx
La sortie affiche la vue transactionnelle.
PowerShell
La commande suivante valide la transaction.
Complete-Transaction
Pour afficher la chaîne finale :
$t.tostring()
PowerShell
Exemple 8 : Gestion des transactions multi-abonnés
Lorsque vous démarrez une transaction alors qu’une autre transaction est en cours, PowerShell ne crée pas de deuxième transaction par défaut. Au lieu de cela, il ajoute un abonné à la transaction actuelle.
Cet exemple montre comment afficher et gérer une transaction multi-abonné.
Commencez par démarrer une transaction dans la HKCU:\Software clé.
Start-Transaction
La commande suivante utilise la Get-Transaction commande pour obtenir la transaction active.
Get-Transaction
Le résultat montre l’objet qui représente la transaction active.
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 1 Active
La commande suivante ajoute la clé MyCompany au Registre. La commande utilise le paramètre UseTransaction pour inclure la commande dans la transaction.
New-Item MyCompany -UseTransaction
La commande suivante utilise la Start-Transaction commande pour démarrer une transaction. Bien que cette commande soit tapée à l’invite de commandes, ce scénario est plus susceptible de se produire lorsque vous exécutez un script qui contient une transaction.
Start-Transaction
Une Get-Transaction commande indique que le nombre d’abonnés sur l’objet de transaction est incrémenté. La valeur est maintenant 2.
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 2 Active
La commande suivante utilise l’applet New-ItemProperty de commande pour ajouter l’entrée de Registre MyKey à la clé MyCompany. Il utilise le paramètre UseTransaction pour inclure la commande dans la transaction.
New-ItemProperty -path MyCompany -name MyKey -UseTransaction
La clé MyCompany n’existe pas dans le Registre, mais cette commande réussit, car les deux commandes font partie de la même transaction.
La commande suivante valide la transaction. S’il a restauré la transaction, la transaction est restaurée pour tous les abonnés.
Complete-Transaction
Une Get-Transaction commande indique que le nombre d’abonnés sur l’objet de transaction est 1, mais que la valeur d’État est toujours active (pas validée).
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 1 Active
Pour terminer la validation de la transaction, entrez une deuxième commande Complete- Transaction. Pour valider une transaction multi-abonné, vous devez entrer une Complete-Transaction commande pour chaque Start-Transaction commande.
Complete-Transaction
Une autre Get-Transaction commande montre que la transaction a été validée.
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 0 Committed
Exemple 9 : Gestion des transactions indépendantes
Lorsque vous démarrez une transaction alors qu’une autre transaction est en cours, vous pouvez utiliser le paramètre Indépendant de Start-Transaction pour rendre la nouvelle transaction indépendante de la transaction d’origine.
Lorsque vous le faites, Start-Transaction crée un objet de transaction et fait de la nouvelle transaction la transaction active.
Commencez par démarrer une transaction dans la HKCU:\Software clé.
Start-Transaction
La commande suivante utilise la Get-Transaction commande pour obtenir la transaction active.
Get-Transaction
Le résultat montre l’objet qui représente la transaction active.
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 1 Active
La commande suivante ajoute la clé de Registre MyCompany dans le cadre de la transaction. Il utilise le paramètre UseTransaction (usetx) pour inclure la commande dans la transaction active.
New-Item MyCompany -use
La commande suivante démarre une nouvelle transaction. La commande utilise le paramètre Independent pour indiquer que cette transaction n’est pas un abonné à la transaction active.
Start-Transaction -Independent
Lorsque vous créez une transaction indépendante, la nouvelle transaction (la plus récente) devient la transaction active. Vous pouvez utiliser une Get-Transaction commande pour obtenir la transaction active.
Get-Transaction
Notez que l’AbonnéCount de la transaction est 1, indiquant qu’il n’y a pas d’autres abonnés et que la transaction est nouvelle.
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 1 Active
La nouvelle transaction doit être terminée (validée ou restaurée) avant de pouvoir gérer la transaction d’origine.
La commande suivante ajoute la clé MyOtherCompany au registre. Il utilise le paramètre UseTransaction (usetx) pour inclure la commande dans la transaction active.
New-Item MyOtherCompany -usetx
Maintenant, restaurez la transaction. S’il y avait une seule transaction avec deux abonnés, la restauration de la transaction annulerait toute la transaction pour tous les abonnés.
Toutefois, étant donné que ces transactions sont indépendantes, la restauration de la transaction la plus récente annule les modifications du Registre et rend la transaction d’origine la transaction active.
Undo-Transaction
Une Get-Transaction commande confirme que la transaction d’origine est toujours active dans la session.
Get-Transaction
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 1 Active
La commande suivante valide la transaction active.
Complete-Transaction
Une Get-ChildItem commande indique que le Registre a été modifié.
dir m*
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
83 1 Microsoft {(default)}
0 0 MyCompany {}
