{"id":51223,"date":"2010-02-22T00:01:00","date_gmt":"2010-02-22T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2010\/02\/22\/hey-scripting-guy-how-can-i-use-transactions-in-windows-powershell-2-0\/"},"modified":"2010-02-22T00:01:00","modified_gmt":"2010-02-22T00:01:00","slug":"hey-scripting-guy-how-can-i-use-transactions-in-windows-powershell-2-0","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/hey-scripting-guy-how-can-i-use-transactions-in-windows-powershell-2-0\/","title":{"rendered":"Hey, Scripting Guy! How Can I Use Transactions in Windows PowerShell 2.0?"},"content":{"rendered":"

\"Bookmark<\/a> <\/p>\n

 <\/p>\n

\"Hey,<\/p>\n

Hey, Scripting Guy! I am primarily a database guy, but I have started using Windows PowerShell because of the Windows PowerShell cmdlets for SQL Server 2008. One thing I like about databases is that I can create a transaction. For example, I can begin a transaction, transfer money from one account to another account, check that the transfer completed properly, and then delete the money from the original account. If the transfer does not complete properly, I roll back the transaction and make no changes. I wish I could do something like that in Windows PowerShell. <\/p>\n

— TL<\/p>\n

\n

 <\/p>\n

\"Hey,Hello TL, <\/p>\n

Microsoft Scripting Guy Ed Wilson here. Your e-mail message brings up a conversation I had with the Scripting Wife many years ago when we were getting ready to leave for Kauai, Hawaii<\/font><\/a>. She went online to our bank to transfer some funds from savings to checking so that we would have more direct access to cash if we needed it (we did; Hawaii is expensive when you come from the southern United States). Because this was a long time ago, the Scripting Wife was not as Internet savvy as she is today. The Internet connection to our bank’s Web site failed in the process of moving the money, and she began to panic. <\/p>\n

At that time, I was doing a lot of database work and had even taught several SQL Server certification classes at the local Microsoft Training Center. I calmly explained to her about the ACID principle<\/font><\/a> that governs transactional database operations and exclaimed that we would simply check our account balances when we arrived in Lihue. If the bank’s database team was so lame as to not follow such a basic principle, we would be changing banks. The bank was smart enough to initiate a transaction at the beginning of the operation, and because the Internet connection failed before completion, the transaction rolled back and the money was still in the savings account. <\/p>\n

The following picture of a honu<\/font><\/a> is one that I took while scuba diving during that trip. <\/p>\n

\"Image<\/p>\n

\n

 <\/p>\n<\/p>\n

TL, the first thing you need to know about using transactions in Windows PowerShell 2.0 is that it requires you to be running a minimal operating system version. The minimum operating system version that supports transactions is Windows Vista. Unfortunately, you can start a transaction on Windows XP, but Windows PowerShell does not generate an error until you attempt to use the transaction. The following image illustrates this.<\/p>\n

\"Image<\/p>\n

\n

 <\/p>\n<\/p>\n

The next thing you need to know about using transactions in Windows PowerShell 2.0 is that the provider must support transactions. Before you check for transaction support, you may wish to load any modules you may have installed. Windows PowerShell 2.0 ships with several default modules, and other modules are available for download from CodePlex<\/a> and other places. In addition, we have been writing our own module during the Weekend Scripter series<\/font><\/a>. To see which modules are loaded, use the Get-Module<\/b> cmdlet. To see available modules, use the Get-Module<\/b> cmdlet with the –listavailable<\/b> parameter. The code list that follows illustrates this:<\/p>\n

PS C:> Get-Module
PS C:> Get-Module -ListAvailable<\/p>\n

ModuleType Name                      <\/span>ExportedCommands
———- —-                      <\/span>—————-
Script     <\/span>BasicFunctions            <\/span>{}
Script     <\/span>ConversionModuleV4        <\/span>{}
Script     <\/span>DotNet                    <\/span>{}
Manifest   <\/span>FileSystem                <\/span>{}
Manifest   <\/span>IsePack                   <\/span>{}
Manifest   <\/span>PowerShellPack            <\/span>{}
Manifest   <\/span>PSCodeGen                 <\/span>{}
Manifest   <\/span>PSImageTools              <\/span>{}
Manifest   <\/span>PSRSS                     <\/span>{}
Manifest   <\/span>PSSystemTools             <\/span>{}
Manifest   <\/span>PSUserTools               <\/span>{}
Manifest   <\/span>TaskScheduler             <\/span>{}
Manifest   <\/span>WPK                       <\/span>{}
Manifest   <\/span>ActiveDirectory           <\/span>{}
Manifest   <\/span>AppLocker                 <\/span>{}
Manifest   <\/span>BitsTransfer              <\/span>{}
Manifest   <\/span>FailoverClusters          <\/span>{}
Manifest   <\/span>GroupPolicy               <\/span>{}
Manifest   <\/span>NetworkLoadBalancingCl… {}
Manifest   <\/span>PSDiagnostics         <\/span>    <\/span>{}
Manifest   <\/span>TroubleshootingPack       <\/span>{}<\/p>\n

<\/font><\/span><\/p>\n

After you have found your list of available modules, you may wish to load all of the modules at once. You can do this by piping the results of your Get-Module –Listavailable<\/b> command to the Import-Module<\/b> cmdlet. Use the Get-Module<\/b> cmdlet to ensure that the modules import properly. The command seen here illustrates this technique:<\/p>\n

PS C:> Get-Module -ListAvailable | Import-Module
PS C:> Get-Module<\/p>\n

ModuleType Name                      <\/span>ExportedCommands
———- —-                      <\/span>—————-
Script     <\/span>BasicFunctions            <\/span>{Get-ComputerInfo, Get-OptimalSize}
Script     <\/span>ConversionModuleV4        <\/span>{ConvertTo-Feet, ConvertTo-Miles, ConvertTo-Pounds, ConvertTo-Meters…}
Script     <\/span>PowerShellPack    <\/span>        <\/span>{New-ByteAnimationUsingKeyFrames, New-TiffBitmapEncoder, New-Viewbox, Ne…
Script     <\/span>PSCodeGen                 <\/span>{New-Enum, New-ScriptCmdlet, New-PInvoke}
Script     <\/span>PSImageTools              <\/span>{Add-CropFilter, Add-RotateFlipFilter, Add-OverlayFilter, Set-ImageFilte…
Script     <\/span>PSRss                     <\/span>{Read-Article, New-Feed, Remove-Article, Remove-Feed…}
Script     <\/span>PSSystemTools             <\/span>{Test-32Bit, Get-USB, Get-OSVersion, Get-MultiTouchMaximum…}
Script     <\/span>PSUserTools               <\/span>{Start-ProcessAsAdministrator, Get-CurrentUser, Test-IsAdministrator, Ge…
Script     <\/span>TaskScheduler             <\/span>{Remove-Task, Get-ScheduledTask, Stop-Task, Add-TaskTrigger…}
Script     <\/span>WPK                       <\/span>{Get-DependencyProperty, New-ModelVisual3D, New-DiscreteVector3DKeyFrame…
Manifest   <\/span>ActiveDirectory           <\/span>{Set-ADOrganizationalUnit, Get-ADDomainControllerPasswordReplicationPoli…
Manifest   <\/span>AppLocker                 <\/span>{Get-AppLockerPolicy, Get-AppLockerFileInformation, Test-AppLockerPolicy…
Manifest   <\/span>BitsTransfer              <\/span>{Start-BitsTransfer, Remove-BitsTransfer, Resume-BitsTransfer, Get-BitsT…
Manifest   <\/span>FailoverClusters          <\/span>{Set-ClusterParameter, Get-ClusterParameter, Stop-ClusterNode, Stop-Clus…
Manifest   <\/span>GroupPolicy         <\/span>      <\/span>{Get-GPStarterGPO, Get-GPOReport, Set-GPInheritance, Restore-GPO…}
Manifest   <\/span>NetworkLoadBalancingCl… {Stop-NlbClusterNode, Remove-NlbClusterVip, New-NlbClusterIpv6Address, S…
Script     <\/span>PSDiagnostics             <\/span>{Enable-PSTrace, Enable-WSManTrace, Start-Trace, Disable-PSWSManComb\nined…
Manifest   <\/span>TroubleshootingPack       <\/span>{Get-TroubleshootingPack, Invoke-TroubleshootingPack}<\/p>\n

<\/font><\/span><\/p>\n

Now that you have imported all of your modules, use the Get-PSProvider<\/b> cmdlet to see which Windows PowerShell providers support transactions. This is shown here:<\/p>\n

PS C:> Get-PSProvider<\/p>\n

Name                 <\/span>Capabilities                                      <\/span>Drives
—-                 <\/span>————                                      <\/span>——
WSMan                <\/span>Credentials  <\/span>                                     <\/span>{WSMan}
Alias                <\/span>ShouldProcess                                     <\/span>{Alias}
Environment          <\/span>ShouldProcess                                     <\/span>{Env}
FileSystem           <\/span>Filter, ShouldProcess             <\/span>                <\/span>{C, E, Desktop, Programs…}
Function             <\/span>ShouldProcess                                     <\/span>{Function}
Registry             <\/span>ShouldProcess, Transactions                       <\/span>{HKLM, HKCU}
Variable             <\/span>ShouldProcess           <\/span>                          <\/span>{Variable}
Certificate          <\/span>ShouldProcess                                     <\/span>{cert}
ActiveDirectory      <\/span>Include, Exclude, Filter, ShouldProcess, Crede… {}<\/p>\n

<\/font><\/span><\/p>\n

The capabilities of the ActiveDirectory<\/b> provider are truncated. To see all of the capabilities of the ActiveDirectory<\/b> provider, pipe the results to Format-List<\/b> (fl<\/b> is the alias), as shown here:<\/p>\n

PS C:> Get-PSProvider act* | fl capabilities<\/p>\n

Capabilities : Include, Exclude, Filter, ShouldProcess, Credentials<\/p>\n

<\/font><\/span><\/p>\n

It would seem that the only provider that supports transactions is the registry provider. To make certain of our results, we can use the Where-Object<\/b> cmdlet (?<\/b> Is the alias) to filter out the results obtained by the Get-PSProvider<\/b> cmdlet, as shown here:<\/p>\n

PS C:> Get-PSProvider | Where-Object { $_.capabilities -match ‘transactions’}<\/p>\n

Name                 <\/span>Capabilities                                      <\/span>Drives
—-                 <\/span>————                                      <\/span>——
Registry             <\/span>ShouldProcess, Transactions                       <\/span>{HKLM, HKCU}<\/p>\n

<\/font><\/span><\/p>\n

 <\/p>\n

TL, that is all there is to understanding transactions in Windows PowerShell. Tomorrow, we will continue working with transactions. <\/p>\n

If you want to know exactly what we will be looking at tomorrow, follow us on Twitter<\/a> or Facebook<\/a>. If you have any questions, send e-mail to\nus at scripter@microsoft.com<\/font><\/a> or post your questions on the Official Scripting Guys Forum<\/a>. See you tomorrow. Until then, peace.<\/p>\n

\n

 <\/p>\n<\/p>\n

Ed Wilson and Craig Liebendorfer, Scripting Guys<\/p>\n

<\/span><\/b><\/p>\n

<\/span><\/b> <\/p>\n","protected":false},"excerpt":{"rendered":"

    Hey, Scripting Guy! I am primarily a database guy, but I have started using Windows PowerShell because of the Windows PowerShell cmdlets for SQL Server 2008. One thing I like about databases is that I can create a transaction. For example, I can begin a transaction, transfer money from one account to another […]<\/p>\n","protected":false},"author":595,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[51,3,45],"class_list":["post-51223","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-getting-started","tag-scripting-guy","tag-windows-powershell"],"acf":[],"blog_post_summary":"

    Hey, Scripting Guy! I am primarily a database guy, but I have started using Windows PowerShell because of the Windows PowerShell cmdlets for SQL Server 2008. One thing I like about databases is that I can create a transaction. For example, I can begin a transaction, transfer money from one account to another […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/51223","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=51223"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/51223\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=51223"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=51223"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=51223"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}