Get-Transaction
Mendapatkan transaksi saat ini (aktif).
Sintaks
Default (Default)
Get-Transaction
Deskripsi
cmdlet Get-Transaction mendapatkan objek yang mewakili transaksi saat ini dalam sesi.
Cmdlet ini tidak pernah mengembalikan lebih dari satu objek, karena hanya satu transaksi yang aktif pada satu waktu. Jika Anda memulai satu atau beberapa transaksi independen (dengan menggunakan parameter Independen Start-Transaction), transaksi yang terakhir dimulai aktif, dan itu adalah transaksi yang Get-Transaction kembalikan.
Ketika semua transaksi aktif telah digulung balik atau diterapkan, cmdlet ini menunjukkan transaksi yang terakhir aktif dalam sesi.
Cmdlet ini adalah salah satu set cmdlet yang mendukung fitur transaksi di Windows PowerShell. Untuk informasi selengkapnya, lihat about_Transactions.
Contoh
Contoh 1: Dapatkan transaksi saat ini
Start-Transaction
Get-Transaction
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 1 Active
Perintah ini menggunakan cmdlet Get-Transaction untuk mendapatkan transaksi saat ini.
Contoh 2: Menampilkan properti dan metode objek transaksi
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;}
Perintah ini menggunakan cmdlet Get-Member untuk menampilkan properti dan metode objek transaksi.
Contoh 3: Menampilkan nilai properti dari transaksi yang digulung balik
Set-Location HKLM:\software
Start-Transaction
New-Item MyCompany -UseTransaction
Undo-Transaction
Get-Transaction
RollbackPreference SubscriberCount Status
------------------ --------------- ----------
Error 0 RolledBack
Perintah ini memperlihatkan nilai properti objek transaksi untuk transaksi yang telah digulung balik.
Contoh 4: Menampilkan nilai properti dari transaksi yang diterapkan
Set-Location HKLM:\software
Start-Transaction
New-Item MyCompany -UseTransaction
Complete-Transaction
Get-Transaction
RollbackPreference SubscriberCount Status
------------------ --------------- ---------
Error 1 Committed
Perintah ini menunjukkan nilai properti objek transaksi untuk transaksi yang telah dilakukan.
Contoh 5: Memulai transaksi saat transaksi lain sedang berlangsung
Set-Location HKLM:\software
Start-Transaction
New-Item MyCompany -UseTransaction
Start-Transaction
New-Item MyCompany2 -UseTransaction
Get-Transaction
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 2 Active
Complete-Transaction
Get-Transaction
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 1 Active
Complete-Transaction
Get-Transaction
RollbackPreference SubscriberCount Status
------------------ --------------- ---------
Error 1 Committed
Contoh ini menunjukkan efek pada objek transaksi memulai transaksi saat transaksi lain sedang berlangsung. Biasanya, ini terjadi ketika skrip yang menjalankan transaksi menyertakan fungsi atau memanggil skrip yang berisi transaksi lengkap lainnya.
Kecuali perintah Start-Transaction kedua menyertakan parameter Independen, Start-Transaction tidak membuat transaksi baru. Sebaliknya, ia menambahkan pelanggan kedua ke transaksi asli.
Perintah Start-Transaction pertama memulai transaksi. Perintah New-Item dengan parameter UseTransaction
Perintah Start-Transaction kedua menambahkan pelanggan ke transaksi. Perintah New-Item berikutnya juga merupakan bagian dari transaksi.
Perintah Get-Transaction pertama menunjukkan transaksi multi-pelanggan.
Perhatikan bahwa jumlah pelanggan adalah 2.
Perintah Complete-Transaction pertama tidak melakukan transaksi, tetapi mengurangi jumlah pelanggan menjadi 1.
Perintah Complete-Transaction kedua melakukan transaksi.
Contoh 6: Memulai transaksi independen saat transaksi lain sedang berlangsung
Set-Location HKLM:\software
Start-Transaction
Get-Transaction
RollbackPreference SubscriberCount IsRolledBack IsCommitted
------------------ --------------- ------------ -----------
Error 1 False False
Start-Transaction -Independent
Get-Transaction
RollbackPreference SubscriberCount IsRolledBack IsCommitted
------------------ --------------- ------------ -----------
Error 1 False False
Complete-Transaction
Get-Transaction
Complete-Transaction
Get-Transaction
Contoh ini menunjukkan efek pada objek transaksi memulai transaksi independen saat transaksi lain sedang berlangsung.
Perintah Start-Transaction pertama memulai transaksi. Perintah New-Item dengan parameter UseTransaction adalah bagian dari transaksi.
Perintah Start-Transaction kedua menambahkan pelanggan ke transaksi. Perintah New-Item berikutnya juga merupakan bagian dari transaksi.
Perintah Get-Transaction pertama menunjukkan transaksi multi-pelanggan. Perhatikan bahwa jumlah pelanggan adalah 2.
Perintah Complete-Transaction mengurangi jumlah pelanggan menjadi 1, tetapi tidak melakukan transaksi.
Perintah Complete-Transaction kedua melakukan transaksi.
Input
None
Anda tidak dapat menyalurkan objek ke cmdlet ini.
Output
PSTransaction
Cmdlet ini mengembalikan objek yang mewakili transaksi saat ini.
