Obtient la transaction actuelle (active).

Syntaxe

Get-Transaction [<CommonParameters>]

Description

L'applet de commande Get-Transaction obtient un objet qui représente la transaction actuelle dans la session.

Cette applet de commande ne retourne jamais plusieurs objets, car une seule transaction est active à la fois. Si vous démarrez une ou plusieurs transactions indépendantes (à l'aide du paramètre Independent de Start-Transaction), c'est la dernière transaction démarrée qui est active et qui est retournée par Get-Transaction.

Lorsque toutes les transactions actives ont été restaurées ou validées, Get-Transaction affiche la dernière transaction active dans la session.

L'applet de commande Get-Transaction fait partie d'un jeu d'applets de commande qui prennent en charge la fonctionnalité des transactions dans Windows PowerShell. Pour plus d'informations, consultez about_Transactions.

Paramètres

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

None

Vous ne pouvez pas diriger des objets vers cette applet de commande.

Sorties

System.Management.Automation.PSTransaction

L'applet de commande Get-Transaction retourne un objet qui représente la transaction actuelle.

Exemple 1

C:\PS>start-transaction

C:\PS> get-transaction 

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

Description
-----------
Cette commande utilise l'applet de commande Get-Transaction pour obtenir la transaction actuelle.






Exemple 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;}

Description
-----------
Cette commande utilise l'applet de commande Get-Member pour afficher les propriétés et les méthodes de l'objet transaction.






Exemple 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

Description
-----------
Cette commande affiche les valeurs de propriété d'un objet transaction d'une transaction restaurée.






Exemple 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

Description
-----------
Cette commande affiche les valeurs de propriété d'un objet transaction d'une transaction validée.






Exemple 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

Description
-----------
Cet exemple illustre le démarrage d'une transaction pendant qu'une autre transaction est en cours et ses effets sur l'objet transaction. En général, cela se produit lorsqu'un script qui exécute une transaction inclut une fonction ou appelle un script qui contient une autre transaction complète.

La commande Start-Transaction ne crée pas de transaction, sauf si la deuxième commande Start-Transaction inclut le paramètre Independent. Au lieu de cela, elle ajoute un deuxième abonné à la transaction d'origine. 

La première commande Start-Transaction démarre la transaction. Une commande New-Item avec le paramètre UseTransaction fait partie de la transaction.

Une deuxième commande Start-Transaction ajoute un abonné à la transaction. La commande New-Item suivante fait également partie de la transaction.

La première commande Get-Transaction affiche la transaction qui comporte plusieurs abonnés. Notez que le nombre d'abonnés a la valeur 2.

La première commande Complete-Transaction ne valide pas la transaction, mais elle réduit le nombre d'abonnés à 1.

La deuxième commande Complete-Transaction valide la transaction.






Exemple 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

Description
-----------
Cet exemple illustre le démarrage d'une transaction indépendante pendant qu'une autre transaction est en cours et ses effets sur l'objet transaction.

La première commande Start-Transaction démarre la transaction. Une commande New-Item avec le paramètre UseTransaction fait partie de la transaction.

Une deuxième commande Start-Transaction ajoute un abonné à la transaction. La commande New-Item suivante fait également partie de la transaction.

La première commande Get-Transaction affiche la transaction qui comporte plusieurs abonnés. Notez que le nombre d'abonnés a la valeur 2.

La commande Complete-Transaction réduit le nombre d'abonnés à 1, mais elle ne valide pas la transaction.

La deuxième commande Complete-Transaction valide la transaction.






Voir aussi




Table des matières