다음을 통해 공유

Use-Transaction

  • 참조
모듈:
Microsoft.PowerShell.Management

활성 트랜잭션에 스크립트 블록을 추가합니다.

구문

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

Description

cmdlet은 Use-Transaction 활성 트랜잭션에 스크립트 블록을 추가합니다. 이렇게 하면 트랜잭션 사용 Microsoft .NET Framework 개체를 사용하여 트랜잭션된 스크립팅을 수행할 수 있습니다. 스크립트 블록은 Microsoft.PowerShell.Commands.Management.TransactedString 클래스의 인스턴스와 같은 트랜잭션 사용 .NET Framework 개체만 포함할 수 있습니다 .

대부분의 cmdlet에 대해 선택 사항인 UseTransaction 매개 변수는 이 cmdlet을 사용할 때 필요합니다.

Use-Transaction 는 Windows PowerShell에서 트랜잭션 기능을 지원하는 cmdlet 집합 중 하나입니다. 자세한 내용은 about_Transactions 참조하세요.

예제

예제 1: 트랜잭션 사용 개체를 사용하여 스크립트

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

이 예제에서는 트랜잭션 사용 .NET Framework 개체에 대해 스크립트를 사용하는 Use-Transaction 방법을 보여 줍니다. 이 경우 개체는 TransactedString 개체입니다.

첫 번째 명령은 cmdlet을 Start-Transaction 사용하여 트랜잭션을 시작합니다.

두 번째 명령은 New-Object 명령을 사용하여 TransactedString 개체를 만듭니다. 개체를 변수에 저장합니다 $TransactedString .

세 번째 명령과 네 번째 명령은 모두 TransactedString 개체의 Append 메서드를 사용하여 텍스트를 값$TransactedString에 추가합니다. 한 명령은 트랜잭션의 일부입니다. 다른 명령은 그렇지 않습니다.

세 번째 명령은 트랜잭션된 문자열의 Append 메서드를 사용하여 Hello를 값$TransactedString에 추가합니다. 명령은 트랜잭션의 일부가 아니므로 변경 내용이 즉시 적용됩니다.

네 번째 명령은 트랜잭션의 문자열에 텍스트를 추가하는 데 사용합니다 Use-Transaction . 이 명령은 Append 메서드를 사용하여 ", World"를 값$TransactedString에 추가합니다. 이 명령은 중괄호({})로 묶어 스크립트 블록으로 만듭니다. 이 명령에는 UseTransaction 매개 변수가 필요합니다.

다섯 번째 및 여섯 번째 명령은 TransactedString 개체의 ToString 메서드를 사용하여 TransactedString의 값을 문자열로 표시합니다. 다시 말하지만, 하나의 명령은 트랜잭션의 일부입니다. 다른 트랜잭션은 그렇지 않습니다.

다섯 번째 명령은 ToString 메서드를 사용하여 $TransactedString 변수의 현재 값을 표시합니다. 트랜잭션의 일부가 아니므로 문자열의 현재 상태만 표시합니다.

여섯 번째 명령은 트랜잭션에서 동일한 명령을 실행하는 데 사용합니다 Use-Transaction . 이 명령은 트랜잭션의 일부이므로 트랜잭션 변경의 미리 보기와 마찬가지로 트랜잭션에서 문자열의 현재 값을 표시합니다.

일곱 번째 명령은 cmdlet을 Complete-Transaction 사용하여 트랜잭션을 커밋합니다.

마지막 명령은 ToString 메서드를 사용하여 변수의 결과 값을 문자열로 표시합니다.

예제 2: 트랜잭션 롤백

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

이 예제에서는 명령이 포함된 Use-Transaction 트랜잭션을 롤백하는 효과를 보여 줍니다. 트랜잭션의 모든 명령과 마찬가지로 트랜잭션이 롤백되면 트랜잭션 변경 내용이 삭제되고 데이터는 변경되지 않습니다.

첫 번째 명령은 트랜잭션을 시작하는 데 사용합니다 Start-Transaction .

두 번째 명령은 TransactedString 개체를 만드는 데 사용합니다New-Object. 개체를 변수에 저장합니다 $TransactedString .

트랜잭션의 일부가 아닌 세 번째 명령은 Append 메서드를 사용하여 "Hello"를 값$TransactedString에 추가합니다.

네 번째 명령은 트랜잭션에서 Append 메서드를 사용하는 다른 명령을 실행하는 데 사용합니다Use-Transaction. 이 명령은 Append 메서드를 사용하여 ", World"를 값$TransactedString에 추가합니다.

다섯 번째 명령은 Undo-Transaction cmdlet을 사용하여 트랜잭션을 롤백합니다. 따라서 트랜잭션에서 수행된 모든 명령이 취소됩니다.

마지막 명령은 ToString 메서드를 사용하여 결과 값을 $TransactedString 문자열로 표시합니다. 결과에는 트랜잭션 외부에서 적용된 변경 내용만 개체에 적용된 것으로 표시됩니다.

매개 변수

-TransactedScript

트랜잭션에서 실행되는 스크립트 블록을 지정합니다. 중괄호({})로 묶인 유효한 스크립트 블록을 입력합니다. 이 매개 변수는 필수입니다.

형식:ScriptBlock
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UseTransaction

활성 트랜잭션에 명령을 포함합니다. 이 매개 변수는 트랜잭션이 진행 중인 경우에만 유효합니다. 자세한 내용은 about_transactions 참조하세요.

형식:SwitchParameter
별칭:usetx
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

None

이 cmdlet에 입력을 파이프할 수 없습니다.

출력

PSObject

이 cmdlet은 트랜잭션의 결과를 반환합니다.

참고

  • UseTransaction 매개 변수에는 활성 트랜잭션의 명령이 포함됩니다. Use-Transaction cmdlet은 항상 트랜잭션에 사용되므로 이 매개 변수는 명령을 Use-Transaction 효과적으로 만드는 데 필요합니다.