Ruft die aktuelle (aktive) Transaktion ab. (Get-Transaction)
NAMEGet-TransactionÜBERSICHTRuft die aktuelle (aktive) Transaktion ab.SYNTAXGet-Transaction [<CommonParameters>]BESCHREIBUNGDas Cmdlet "Get-Transaction" ruft ein Objekt ab, das die aktuelle Transaktion in der Sitzung darstellt. Dieses Cmdlet gibt nie mehr als ein Objekt zurück, da jeweils nur eine Transaktion aktiv ist. Wenn Sie eine oder mehrere unabhängige Transaktionen (mit dem Independent-Parameter von Start-Transaction) starten, ist die zuletzt gestartete Transaktion aktiv. Diese Transaktion wird von Get-Transaction zurückgegeben. Wenn alle aktiven Transaktionen zurückgesetzt wurden oder ein Commit ausgeführt wurde, zeigt Get-Transaction die Transaktion an, die zuletzt in der Sitzung aktiv war. Das Cmdlet "Get-Transaction" gehört zu einem Satz von Cmdlets, die das Transaktionsfeature in Windows PowerShell unterstützen. Weitere Informationen finden Sie unter "about_Transactions".PARAMETER<CommonParameters> Dieses Cmdlet unterstützt folgende allgemeine Parameter: "Verbose", "Debug", "ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable", "OutBuffer" und "OutVariable". Weitere Informationen erhalten Sie mit dem Befehl "get-help about_commonparameters".EINGABENKeiner Objekte können nicht über die Pipeline an dieses Cmdlet übergeben werden.AUSGABENSystem.Management.Automation.PSTransaction Das Cmdlet "Get-Transaction" gibt ein Objekt zurück, das die aktuelle Transaktion darstellt.HINWEISEBeispiele
BEISPIEL 1C:\PS>start-transaction C:\PS> get-transaction RollbackPreference SubscriberCount Status ------------------ --------------- ------ Error 1 Active Beschreibung ----------- Dieser Befehl ruft mit dem Cmdlet "Get-Transaction" die aktuelle Transaktion ab.BEISPIEL 2C:\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;} Beschreibung ----------- Dieser Befehl zeigt mit dem Cmdlet "Get-Member" die Eigenschaften und Methoden des Transaktionsobjekts an.BEISPIEL 3C:\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 Beschreibung ----------- Dieser Befehl zeigt die Eigenschaftenwerte eines Transaktionsobjekts für eine Transaktion an, die zurückgesetzt wurde.BEISPIEL 4C:\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 Beschreibung ----------- Dieser Befehl zeigt die Eigenschaftenwerte eines Transaktionsobjekts für eine Transaktion an, für die ein Commit ausgeführt wurde.BEISPIEL 5C:\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 Beschreibung ----------- In diesem Beispiel werden die Auswirkungen auf das Transaktionsobjekt veranschaulicht, wenn eine Transaktion gestartet wird, während eine andere Transaktion ausgeführt wird. Dies geschieht normalerweise, wenn ein Skript, das eine Transaktion ausführt, eine Funktion enthält oder ein Skript aufruft, die bzw. das eine andere vollständige Transaktion enthält. Wenn der zweite Befehl "Start-Transaction" den Independent-Parameter nicht einschließt, erstellt Start-Transaction keine neue Transaktion. Stattdessen wird der ursprünglichen Transaktion ein zweiter Abonnent hinzugefügt. Der erste Befehl "Start-Transaction" startet die Transaktion. Der Befehl "New-Item" mit dem UseTransaction-Parameter ist Teil der Transaktion. Der zweite Befehl "Start-Transaction" fügt der Transaktion einen Abonnenten hinzu. Der nächste Befehl "New-Item" ist ebenfalls Teil der Transaktion. Der erste Befehl "Get-Transaction" zeigt die Transaktion mit mehreren Abonnenten an. Beachten Sie, dass die Abonnentenanzahl 2 beträgt. Der erste Befehl "Complete-Transaction" führt keinen Commit für die Transaktion aus, die Abonnentenanzahl wird jedoch auf 1 verringert. Der zweite Befehl "Complete-Transaction" führt einen Commit für die Transaktion aus.BEISPIEL 6C:\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 Beschreibung ----------- In diesem Beispiel werden die Auswirkungen auf das Transaktionsobjekt veranschaulicht, wenn eine unabhängige Transaktion gestartet wird, während eine andere Transaktion ausgeführt wird. Der erste Befehl "Start-Transaction" startet die Transaktion. Der Befehl "New-Item" mit dem UseTransaction-Parameter ist Teil der Transaktion. Der zweite Befehl "Start-Transaction" fügt der Transaktion einen Abonnenten hinzu. Der nächste Befehl "New-Item" ist ebenfalls Teil der Transaktion. Der erste Befehl "Get-Transaction" zeigt die Transaktion mit mehreren Abonnenten an. Beachten Sie, dass die Abonnentenanzahl 2 beträgt. Der Befehl "Complete-Transaction" verringert die Anzahl der Abonnenten auf 1, führt jedoch keinen Commit für die Transaktion aus. Der zweite Befehl "Complete-Transaction" führt einen Commit für die Transaktion aus. VERWANDTE LINKS Online version: http://go.microsoft.com/fwlink/?LinkID=135220 (möglicherweise auf Englisch) about_Transactions about_Providers Start-Transaction Complete-Transaction Undo-Transaction Use-Transaction C:\Windows>powershell get-help Start-Transaction -full
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export
