Undo-Transaction

Modül:
Microsoft.PowerShell.Management Module

Etkin işlemi geri alır.

Syntax

Default (Varsayılan) 

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

Description

Undo-Transaction cmdlet'i etkin işlemi geri alır. Bir işlemi geri aldığınızda, işlemdeki komutlar tarafından yapılan değişiklikler atılır ve veriler özgün biçimine geri yüklenir.

İşlem birden çok abone içeriyorsa, bir Undo-Transaction komutu tüm aboneler için işlemin tamamını geri alır.

Varsayılan olarak, işlemdeki herhangi bir komut hata oluşturursa işlemler otomatik olarak geri alınır. Ancak işlemler farklı bir geri alma tercihi kullanılarak başlatılabilir ve etkin işlemi istediğiniz zaman geri almak için bu cmdlet'i kullanabilirsiniz.

Undo-Transaction cmdlet'i, Windows PowerShell'deki işlemler özelliğini destekleyen bir cmdlet kümesidir. Daha fazla bilgi için bkz. about_Transactions.

Örnekler

Örnek 1: Geçerli işlemi geri alma

Undo-Transaction

Bu komut geçerli, etkin işlemi geri alır.

Örnek 2: bir işlemi başlatma ve geri alma

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

Bu örnek bir işlem başlatır ve ardından geri alır. Sonuç olarak, kayıt defterinde hiçbir değişiklik yapılmaz.

Örnek 3: Tüm aboneler için bir işlemi geri alma

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

Bu örnekte herhangi bir abone bir işlemi geri alırsa tüm işlemin tüm aboneler için geri alındığını gösterir.

İlk komut konumu HKCU:\Software kayıt defteri anahtarına değiştirir.

İkinci komut bir işlem başlatır.

Üçüncü komut, yeni bir kayıt defteri anahtarı oluşturmak için New-Item cmdlet'ini kullanır. Komut, değişikliği işleme dahil etmek için UseTransaction parametresini kullanır.

Dördüncü komut, etkin işlemi almak için Get-Transaction cmdlet'ini kullanır. Durumun Etkin ve abone sayısının 1 olduğuna dikkat edin.

Beşinci komut yeniden Start-Transaction komutunu kullanır. Genellikle, başka bir işlem devam ederken bir işlemin başlatılması, ana işlem tarafından kullanılan bir betik kendi tam işlemini içerdiğinde gerçekleşir. Bu örnek, aşamalar halinde inceleyebilmeniz için etkileşimli olarak gerçekleştirilir. Başka bir işlem devam ederken bir Start-Transaction komutu çalıştırdığınızda komutlar mevcut işlemi yeni abone olarak birleştirir ve abone sayısı artırılır.

Altıncı komut, etkin işlemi almak için Get-Transaction cmdlet'ini kullanır. Abone sayısının artık 2 olduğuna dikkat edin.

Yedinci komut, işlemi geri almak için Undo-Transaction kullanır. Bu komut hiçbir nesne döndürmez.

Son komut, etkin veya bu durumda en son etkin olan işlemi alan bir Get-Transaction komutudur. Sonuçlar, işlemin geri alındığını ve abone sayısının 0 olduğunu gösterir ve işlemin tüm aboneler için geri alındığını gösterir.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Bu cmdlet'e giriş kanalı yapamazsınız.

Çıkışlar

None

Bu cmdlet herhangi bir çıkış döndürmez.

Notlar

  • Kaydedilmiş bir işlemi geri alamazsınız.

    Etkin işlem dışında hiçbir işlemi geri alamazsınız. Farklı ve bağımsız bir işlemi geri almak için önce etkin işlemi işlemeniz veya geri almanız gerekir.

    İşlemin geri döndürülmesi işlemi sonlandırır. Bir işlemi yeniden kullanmak için yeni bir işlem başlatmanız gerekir.