Get-Transaction

NOM
    Get-Transaction

RÉSUMÉ
    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, WarningAction, WarningVariable,
        OutBuffer et OutVariable. Pour plus d'informations, tapez
        « get-help about_commonparameters ».

ENTRÉES
    Aucun
        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.


NOTES





    -------------------------- 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.






LIENS CONNEXES
    Online version: http://go.microsoft.com/fwlink/?LinkID=135220
    about_Transactions
    about_Providers
    Start-Transaction
    Complete-Transaction
    Undo-Transaction
    Use-Transaction