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