À propos des transactions
DESCRIPTION COURTE
Décrit comment gérer les opérations traitées dans PowerShell.
DESCRIPTION DÉTAILLÉE
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.
À PROPOS DES TRANSACTIONS
Dans PowerShell, une transaction est un ensemble d’une ou plusieurs commandes gérées en tant qu’unité logique. Une transaction peut être effectué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’elles échouent toutes, mais que certaines commandes réussissent tandis que d’autres échouent, laissant le système dans un état endommagé, faux ou ininterprétable qui est difficile à réparer.
APPLETS DE COMMANDE TRANSACTION
PowerShell comprend 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 avec transaction.
- Annuler la 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 PRENANT EN CHARGE 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 PowerShell Registry prend en charge les transactions dans Windows Vista. L’objet TransactedString (Microsoft.PowerShell.Commands.Management.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é Capabilities des fournisseurs :
get-psprovider | where {$_.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 en l’absence de 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 TRANSACTION
Les transactions sont représentées dans PowerShell par un objet de transaction, System.Management.Automation.Transaction.
L'objet a les propriétés suivantes :
RollbackPreference : contient l’ensemble de préférences de restauration pour la transaction actuelle. Vous pouvez définir la préférence de restauration lorsque vous utilisez Start-Transaction pour 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, TerminatetingError et Never. La valeur par défaut est Error.
État : contient le status actuel de la transaction. Les valeurs valides sont Active, Committed et RolledBack.
SubscriberCount : contient le nombre d’abonnés à la transaction. Un abonné est ajouté à une transaction lorsque vous démarrez une transaction alors 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 seule la dernière transaction démarrée est active.
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 de commande Get-Transaction. Lorsque vous entrez une commande Get-Transaction, Get-Transaction obtient toujours un seul objet transactionnel. 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 supprimant. Lorsque vous effectuez cette opération, la transaction précédente devient automatiquement active. Les transactions deviennent actives dans l’ordre inverse dans lequel elles sont démarrées, de sorte que la dernière transaction démarrée est 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 commande Undo-Transaction à tout moment annule l’intégralité de la transaction pour tous les abonnés. Toutefois, pour valider la transaction, vous devez entrer une commande Complete-Transaction pour chaque abonné.
Pour rechercher le nombre d’abonnés à une transaction, case activée la propriété SubscriberCount de l’objet transaction. Par exemple, la commande suivante utilise l’applet de commande Get-Transaction 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 en cours à l’aide du paramètre Independent de l’applet de commande Start-Transaction.
Lorsque vous démarrez une transaction indépendante, Start-Transaction crée un objet de transaction 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 redevient 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 cela à l’esprit lorsque vous utilisez des transactions pour gérer des 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êchant 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. Il n’est pas lié aux transactions. Si vous travaillez dans un système de fichiers avec 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 PowerShell Registry 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 commande Start-Transaction. 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 lecteur HKCU :, 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 de commande New-Item pour inclure la commande dans la transaction active.
new-item MyCompany -UseTransaction
La commande retourne un objet qui représente la nouvelle clé, mais comme 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 commande Complete-Transaction. Étant donné qu’elle affecte toujours la transaction active, vous ne pouvez pas spécifier la transaction.
complete-transaction
Par conséquent, la clé MyCompany 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 commande Start-Transaction. 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 de commande New-Item pour inclure la commande dans la transaction active.
new-item MyOtherCompany -UseTransaction
La commande retourne un objet qui représente la nouvelle clé, mais comme 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 commande Undo-Transaction. Étant donné qu’elle affecte toujours la transaction active, vous ne spécifiez pas la transaction.
Undo-transaction
Le résultat est que la clé MyOtherCompany 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 modifient les données. Toutefois, les commandes qui obtiennent des données sont également utiles dans une transaction, car elles obtiennent des données à l’intérieur de la transaction. Cela fournit un aperçu des modifications que la validation de la transaction entraînerait.
L’exemple suivant montre comment utiliser la commande Get-ChildItem (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 de commande New-ItemProperty pour ajouter l’entrée de Registre MyKey à 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 du Registre n’est pas modifiée.
MyKey
-----
123
Pour obtenir les éléments actuellement dans le Registre, utilisez une commande Get-ChildItem (« 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 clé MyCompany.
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 commande Get-ChildItem (« dir ») avec le paramètre UseTransaction. Cette commande a une vue des données de la transaction.
dir m* -useTransaction
Le résultat indique que, si la transaction est validée, l’entrée MyKey est ajoutée à la clé MyCompany.
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 Registre HKCU :\Software.
start-transaction
Les trois commandes suivantes utilisent l’applet de commande New-Item pour ajouter des clés au Registre. Les première 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 prend effet immédiatement.
new-item MyCompany1 -UseTransaction
new-item MyCompany2
new-item MyCompany3 -UseTransaction
Pour afficher l’état actuel du Registre, utilisez une commande Get-ChildItem (« dir ») sans le paramètre UseTransaction. Cette commande obtient les éléments qui commencent par « M ».
dir m*
Le résultat indique que la clé MyCompany2 est ajoutée au Registre, mais que les clés MyCompany1 et MyCompany3, 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 ajoutées dans le cadre de la transaction s’affichent 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 quelque nature que ce soit, 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. Les erreurs ne sont donc pas attendues et doivent mettre fin à la transaction.
La première commande démarre une transaction dans la clé de Registre HKCU :\Software.
start-transaction
La commande suivante utilise l’applet de commande New-Item pour ajouter la clé MyCompany 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 clé MyCompany 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 commande Get-Transaction confirme que la transaction a été restaurée et que le nombre d’abonnés 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 de Start-Transaction pour modifier la préférence.
La commande suivante démarre une transaction avec une préférence de restauration « Jamais ».
start-transaction -rollbackpreference Never
Dans ce cas, lorsque la commande échoue, la transaction n’est pas automatiquement restaurée.
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 soumettre à nouveau la commande dans le cadre de la transaction.
New-Item MyOtherCompany -UseTX
EXEMPLE 7 : UTILISATION DE L’APPLET DE COMMANDE USE-TRANSACTION
L’applet de commande Use-Transaction vous permet d’effectuer des scripts directs sur des objets Microsoft .NET Framework avec transaction. Use-Transaction prend un bloc de script qui ne peut contenir que des commandes et des expressions qui utilisent des objets .NET Framework 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 New-Object suivante crée un instance de la classe TransactedString et l’enregistre dans la variable $t.
$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 prend effet 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 dans des accolades et elle est définie comme valeur du paramètre ScriptBlock de Use-Transaction. Le paramètre UseTransaction (UseTx) est obligatoire.
use-transaction {$t.append(" PowerShell")} -usetx
Pour afficher le contenu actuel de la chaîne traitée dans $t, utilisez la méthode ToString 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 commande Use-Transaction.
use-transaction {$s.tostring()} -usetx
La sortie affiche l’affichage transactionnel.
PowerShell
La commande suivante valide la transaction.
complete-transaction
Pour voir 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 une 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és.
Commencez par démarrer une transaction dans la clé HKCU :\Software.
start-transaction
La commande suivante utilise la commande Get-Transaction 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 commande Start-Transaction 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 commande Get-Transaction 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 de commande New-ItemProperty 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 annulé la transaction, la transaction est annulée pour tous les abonnés.
complete-transaction
Une commande Get-Transaction indique que le nombre d’abonnés sur l’objet de transaction est 1, mais que la valeur État est toujours Active (non 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és, vous devez entrer une commande Complete-Transaction pour chaque commande Start-Transaction.
complete-transaction
Une autre commande Get-Transaction indique que la transaction a été validée.
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 0 Committed
EXEMPLE 9 : GESTION DES TRANSACTIONS INDÉPENDANTES
Quand vous démarrez une transaction alors qu’une autre transaction est en cours, vous pouvez utiliser le paramètre Independent de Start-Transaction pour rendre la nouvelle transaction indépendante de la transaction d’origine.
Dans ce cas, 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 clé HKCU :\Software.
start-transaction
La commande suivante utilise la commande Get-Transaction 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 commande Get-Transaction pour obtenir la transaction active.
get-transaction
Notez que le nombre d’abonnés de la transaction est 1, ce qui indique 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 l’intégralité de la transaction pour tous les abonnés.
Toutefois, étant donné que ces transactions sont indépendantes, la restauration de la dernière transaction annule les modifications apportées au Registre et rend la transaction d’origine la transaction active.
undo-transaction
Une commande Get-Transaction 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 commande Get-ChildItem 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 {}