Get-Transaction

Geçerli (etkin) işlemi alır.

Syntax

Default (Varsayılan)

Get-Transaction

Description

Get-Transaction cmdlet'i oturumdaki geçerli işlemi temsil eden bir nesne alır.

Aynı anda yalnızca bir işlem etkin olduğundan bu cmdlet hiçbir zaman birden fazla nesne döndürmez. Bir veya daha fazla bağımsız işlem başlatırsanız (Start-TransactionBağımsız parametresini kullanarak), en son başlatılan işlem etkindir ve bu da Get-Transaction döndürdüğü işlemdir.

Tüm etkin işlemler geri alındığında veya işlendiğinde, bu cmdlet oturumda en son etkin olan işlemi gösterir.

Bu cmdlet, 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 alma

Start-Transaction
Get-Transaction
RollbackPreference   SubscriberCount   Status
------------------   ---------------   ------
Error                1                 Active

Bu komut geçerli işlemi almak için Get-Transaction cmdlet'ini kullanır.

Örnek 2: İşlem nesnesinin özelliklerini ve yöntemlerini gösterme

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;}

Bu komut, işlem nesnesinin özelliklerini ve yöntemlerini göstermek için Get-Member cmdlet'ini kullanır.

Örnek 3: Geri alınan bir işlemin özellik değerlerini gösterme

Set-Location HKLM:\software
Start-Transaction
New-Item MyCompany -UseTransaction
Undo-Transaction
Get-Transaction
RollbackPreference   SubscriberCount   Status
------------------   ---------------   ----------
Error                0                 RolledBack

Bu komut, geri alınmış bir işlem için bir işlem nesnesinin özellik değerlerini gösterir.

Örnek 4: Kaydedilmiş bir işlemin özellik değerlerini gösterme

Set-Location HKLM:\software
Start-Transaction
New-Item MyCompany -UseTransaction
Complete-Transaction
Get-Transaction
RollbackPreference   SubscriberCount   Status
------------------   ---------------   ---------
Error                1                 Committed

Bu komut, kaydedilmiş bir işlem için bir işlem nesnesinin özellik değerlerini gösterir.

Örnek 5: Başka bir işlem devam ederken işlem başlatma

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

Bu örnek, başka bir işlem devam ederken işlem başlatma işleminin işlem nesnesi üzerindeki etkisini gösterir. Genellikle, bir işlem çalıştıran bir betik bir işlev içerdiğinde veya başka bir tam işlem içeren bir betik çağırdığında bu durum ortaya çıkar.

İkinci Start-Transaction komutu Independent parametresini içermediği sürece Start-Transaction yeni bir işlem oluşturmaz. Bunun yerine, özgün işleme ikinci bir abone ekler.

İlk Start-Transaction komutu işlemi başlatır. UseTransaction parametresine sahip bir New-Item komutu işlemin bir parçasıdır.

İkinci bir Start-Transaction komutu işleme abone ekler. Sonraki New-Item komutu da işlemin bir parçasıdır.

İlk Get-Transaction komutu, çok aboneli işlemi gösterir. Abone sayısının 2 olduğuna dikkat edin.

İlk Complete-Transaction komutu işlemi işlemez, ancak abone sayısını 1'e düşürür.

İkinci Complete-Transaction komutu işlemi işler.

Örnek 6: Başka bir işlem devam ederken bağımsız bir işlem başlatma

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

Bu örnek, başka bir işlem devam ederken bağımsız bir işlem başlatma işleminin işlem nesnesi üzerindeki etkisini gösterir.

İlk Start-Transaction komutu işlemi başlatır. New-Item parametresine sahip bir komutu işlemin bir parçasıdır.

İkinci bir Start-Transaction komutu işleme abone ekler. Sonraki New-Item komutu da işlemin bir parçasıdır.

İlk Get-Transaction komutu, çok aboneli işlemi gösterir. Abone sayısının 2 olduğunu unutmayın.

Complete-Transaction komutu abone sayısını 1'e düşürür, ancak işlemi işlemez.

İkinci Complete-Transaction komutu işlemi işler.

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

PSTransaction

Bu cmdlet geçerli işlemi temsil eden bir nesne döndürür.