Undo-Transaction

  • Referensi
Modul:
Microsoft.PowerShell.Management

Mengembalikan transaksi aktif.

Sintaks

Undo-Transaction
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deskripsi

Undo-Transaction Cmdlet mengembalikan transaksi aktif. Saat Anda mengembalikan transaksi, perubahan yang dilakukan oleh perintah dalam transaksi dibuang dan data dipulihkan ke bentuk aslinya.

Jika transaksi mencakup beberapa pelanggan, perintah Undo-Transaction akan mengembalikan seluruh transaksi untuk semua pelanggan.

Secara default, transaksi digulung balik secara otomatis jika ada perintah dalam transaksi yang menghasilkan kesalahan. Namun, transaksi dapat dimulai dengan menggunakan preferensi putar kembali yang berbeda dan Anda dapat menggunakan cmdlet ini untuk mengembalikan transaksi aktif kapan saja.

Undo-Transaction Cmdlet adalah salah satu set cmdlet yang mendukung fitur transaksi di Windows PowerShell. Untuk informasi selengkapnya, lihat about_Transactions.

Contoh

Contoh 1: Mengembalikan transaksi saat ini

Undo-Transaction

Perintah ini menggulung balik transaksi saat ini, aktif, dan saat ini.

Contoh 2: Memulai dan mengembalikan transaksi

Set-Location hkcu:\software
Start-Transaction
New-Item -Path "ContosoCompany" -UseTransaction
Undo-Transaction

Contoh ini memulai transaksi lalu mengembalikannya. Akibatnya, tidak ada perubahan yang dilakukan pada registri.

Contoh 3: Mengembalikan transaksi untuk semua pelanggan

Set-Location hkcu:\software
Start-Transaction
New-Item -Path "ContosoCompany" -UseTransaction
Get-Transaction

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

Start-Transaction
Get-Transaction

RollbackPreference   SubscriberCount   Status
------------------   ---------------   -----
Error                2                 Active

Undo-Transaction
Get-Transaction

RollbackPreference   SubscriberCount   Status
------------------   ---------------   -----
Error                0                 RolledBack

Contoh ini menunjukkan bahwa ketika pelanggan mengembalikan transaksi, seluruh transaksi digulung balik untuk semua pelanggan.

Perintah pertama mengubah lokasi ke HKCU:\Software kunci registri.

Perintah kedua memulai transaksi.

Perintah ketiga menggunakan cmdlet untuk membuat kunci registri New-Item baru. Perintah menggunakan parameter UseTransaction untuk menyertakan perubahan dalam transaksi.

Perintah keempat menggunakan Get-Transaction cmdlet untuk mendapatkan transaksi aktif. Perhatikan bahwa statusnya Aktif dan jumlah pelanggan adalah 1.

Perintah kelima menggunakan Start-Transaction perintah lagi. Biasanya, memulai transaksi saat transaksi lain sedang berlangsung terjadi ketika skrip yang digunakan oleh transaksi utama mencakup transaksi lengkapnya sendiri. Contoh ini dilakukan secara interaktif sehingga Anda dapat memeriksanya secara bertahap. Saat Anda menjalankan Start-Transaction perintah saat transaksi lain sedang berlangsung, perintah bergabung dengan transaksi yang ada sebagai pelanggan baru dan jumlah pelanggan bertambah.

Perintah keenam menggunakan Get-Transaction cmdlet untuk mendapatkan transaksi aktif. Perhatikan bahwa jumlah pelanggan sekarang adalah 2.

Perintah ketujuh Undo-Transaction menggunakan untuk mengembalikan transaksi. Perintah ini tidak mengembalikan objek apa pun.

Perintah akhir adalah Get-Transaction perintah yang aktif, atau dalam hal ini, transaksi terbaru aktif. Hasilnya menunjukkan bahwa transaksi digulung balik, dan jumlah pelanggan adalah 0, menunjukkan bahwa transaksi digulung balik untuk semua pelanggan.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Anda tidak dapat menyalurkan input ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output apa pun.

Catatan

  • Anda tidak dapat mengembalikan transaksi yang telah dilakukan.

    Anda tidak dapat mengembalikan transaksi apa pun selain transaksi aktif. Untuk mengembalikan transaksi independen yang berbeda, Anda harus terlebih dahulu menerapkan atau mengembalikan transaksi aktif.

    Menggulung balik transaksi mengakhiri transaksi. Untuk menggunakan transaksi lagi, Anda harus memulai transaksi baru.