Use-Transaction

  • Referencia
Modul:
Microsoft.PowerShell.Management

Hozzáadja a szkriptblokkot az aktív tranzakcióhoz.

Syntax

Use-Transaction
   [-TransactedScript] <ScriptBlock>
   [-UseTransaction]
   [<CommonParameters>]

Description

A Use-Transaction parancsmag egy szkriptblokkot ad hozzá egy aktív tranzakcióhoz. Ez lehetővé teszi, hogy tranzakcióalapú Microsoft-.NET-keretrendszer-objektumokkal végezhessen tranzakciós szkripteket. A szkriptblokk csak tranzakcióbarát .NET-keretrendszer objektumokat tartalmazhat, például a Microsoft.PowerShell.Commands.Management.TransactedString osztály példányait.

A legtöbb parancsmaghoz nem kötelező UseTransaction paraméterre van szükség a parancsmag használatakor.

Use-Transaction a Windows PowerShell tranzakciós funkcióját támogató parancsmagok egyike. További információ: about_Transactions.

Példák

1. példa: Szkript tranzakcióbarát objektum használatával

Start-Transaction
$transactedString = New-Object Microsoft.PowerShell.Commands.Management.TransactedString
$transactedString.Append("Hello")
Use-Transaction -TransactedScript { $transactedString.Append(", World") } -UseTransaction
$transactedString.ToString()

Hello

Use-Transaction -TransactedScript { $transactedString.ToString() } -UseTransaction

Hello, World

Complete-Transaction
$transactedString.ToString()

Hello, World

Ez a példa azt mutatja be, hogyan lehet parancsfájlt használni Use-Transaction tranzakcióbarát .NET-keretrendszer objektumon. Ebben az esetben az objektum egy TransactedString objektum.

Az első parancs a Start-Transaction parancsmaggal indít el egy tranzakciót.

A második parancs a New-Object paranccsal hoz létre egy TransactedString objektumot. Az objektumot a $TransactedString változóban tárolja.

A harmadik és a negyedik parancs egyaránt a TransactedString objektum Append metódusával ad hozzá szöveget az értékhez$TransactedString. Az egyik parancs a tranzakció része. A másik parancs nem.

A harmadik parancs az átjátszott sztring Append metódusával adja hozzá a Hello értéket $TransactedString. Mivel a parancs nem része a tranzakciónak, a rendszer azonnal alkalmazza a módosítást.

A negyedik parancs szöveget ad Use-Transaction hozzá a tranzakció sztringéhez. A parancs a Hozzáfűzés metódust használja a ", World" értékhez való $TransactedStringhozzáadásához. A parancs kapcsos{} zárójelek közé van zárva, hogy szkriptblokk legyen. Ebben a parancsban a UseTransaction paraméterre van szükség.

Az ötödik és hatodik parancs a TransactedString objektum ToString metódusával jeleníti meg a TransactedString értékét sztringként. Ismét egy parancs a tranzakció része. A másik tranzakció nem.

Az ötödik parancs a ToString metódussal jeleníti meg a $TransactedString változó aktuális értékét. Mivel nem része a tranzakciónak, csak a sztring aktuális állapotát jeleníti meg.

A hatodik parancs ugyanazt a parancsot futtatja Use-Transaction a tranzakcióban. Mivel a parancs a tranzakció része, a tranzakció sztringjének aktuális értékét jeleníti meg, hasonlóan a tranzakció változásainak előnézetéhez.

A hetedik parancs a Complete-Transaction parancsmaggal véglegesíti a tranzakciót.

Az utolsó parancs a ToString metódust használja a változó eredményül kapott értékének sztringként való megjelenítéséhez.

2. példa: Tranzakció visszaállítása

Start-Transaction
$transactedString = New-Object Microsoft.PowerShell.Commands.Management.TransactedString
$transactedString.Append("Hello")
Use-Transaction -TransactedScript { $transactedString.Append(", World") } -UseTransaction
Undo-Transaction
$transactedString.ToString()

Hello

Ez a példa a parancsokat tartalmazó Use-Transaction tranzakciók visszaállításának hatását mutatja be. A tranzakció összes parancsához hasonlóan a tranzakció visszaállításakor a rendszer elveti a végrehajtott módosításokat, és az adatok változatlanok maradnak.

Az első parancs egy tranzakció elindítására használja Start-Transaction .

A második parancs egy TransactedString objektum létrehozásához használjaNew-Object. Az objektumot a $TransactedString változóban tárolja.

A harmadik parancs, amely nem része a tranzakciónak, a Hozzáfűzés metódus használatával adja hozzá a "Hello" értéket a következő értékhez $TransactedString: .

A negyedik parancs egy másik parancs futtatására használ Use-Transaction , amely a tranzakció Append metódusát használja. A parancs a Hozzáfűzés metódust használja a ", World" értékhez való $TransactedStringhozzáadásához.

Az ötödik parancs a Undo-Transaction parancsmaggal visszaállítja a tranzakciót. Ennek eredményeképpen a tranzakcióban végrehajtott összes parancs vissza lesz fordítva.

Az utolsó parancs a ToString metódussal jeleníti meg az eredményül kapott értéket $TransactedString sztringként. Az eredmények azt mutatják, hogy csak a tranzakción kívül végrehajtott módosítások lettek alkalmazva az objektumra.

Paraméterek

-TransactedScript

Megadja a tranzakcióban futtatott szkriptblokkot. Adja meg a kapcsos zárójelekben () található érvényes szkriptblokkokat{}. Ez a paraméter kötelező.

Type:ScriptBlock
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UseTransaction

Tartalmazza a parancsot az aktív tranzakcióban. Ez a paraméter csak akkor érvényes, ha egy tranzakció folyamatban van. További információ: about_transactions.

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

Bevitelek

None

Ehhez a parancsmaghoz nem csövezhet be bemenetet.

Kimenetek

PSObject

Ez a parancsmag a tranzakció eredményét adja vissza.

Jegyzetek

  • A UseTransaction paraméter tartalmazza az aktív tranzakció parancsát. Mivel a Use-Transaction parancsmagot mindig a tranzakciókban használják, ez a paraméter szükséges a Use-Transaction parancsok hatékonyságának eléréséhez.