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

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

 <\/p>\n

\"Hey,<\/p>\n

Hey, Scripting Guy! I have been using Windows PowerShell to manipulate the registry since Windows PowerShell 1.0 came out. With Windows PowerShell 2.0, I can now edit the registry on a remote computer. How can I use transactions with the registry provider so that I can ensure that my changes to the registry do not fail in midstream?<\/p>\n

— SK<\/p>\n

\n

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

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

Microsoft Scripting Guy Ed Wilson here. The rains came to Charlotte, North Carolina, and washed away the remnants of our recent snowfall<\/a> (the picture is actually of our first snowfall, but the second was like the first). On cold rainy days, I like to have a pot of tea near my desk. This afternoon it is Earl Grey tea<\/a> with lemon grass<\/font><\/a>, and a cinnamon stick<\/font><\/a>. I am also munching on some oatmeal and some apple walnut cookies<\/font><\/a> the Scripting Wife baked. She uses the apples and avoids adding any extra sugar to the mix. The cool damp weather reminds me of a day I spent at Fisherman’s Wharf<\/font><\/a> in San Francisco, California, when I was out there teaching a VBScript workshop. I took the following picture that day. <\/p>\n

\"Image<\/p>\n

\n

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

To use a transaction in the registry, you must first start a transaction. To do this, use the Start-Transaction<\/b> cmdlet as seen here:<\/p>\n

PS C:> Start-Transaction<\/p>\n

Suggestion [1,Transactions]: Once a transaction is started, only commands that get called with the -UseTransact
become part of that transaction.
PS C:><\/p>\n

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

It is rather annoying that the suggestion always pops up when you start a new transaction. I have tried piping to the Out-Null<\/b> cmdlet, or redirecting to $null<\/b>, but the message is still displayed. There does not appear to be a parameter that can suppress this message. <\/p>\n

After you have started the transaction, you can use the transaction to create a new registry key. To use the transaction, you use the –useTransaction<\/b> switched parameter on the cmdlet. The following command will create a new registry key when the transaction is completed:<\/p>\n

PS C:> New-Item -Name test2 -Path HKCU:SoftwareScriptingGuys -Value testValue -UseTransaction<\/p>\n

    <\/span>Hive: HKEY_CURRENT_USERSoftwareScriptingGuys<\/p>\n

SKC  <\/span>VC Name                           <\/span>Property
—  <\/span>— —-                           <\/span>——–
  <\/span>0   <\/span>1 test2                          <\/span>{(default)}<\/p>\n

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

At this point, the transaction has not completed; therefore, the new registry key does not yet appear in the registry. The following image confirms that the key is not yet created.<\/p>\n

\"Image<\/p>\n

\n

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

To complete the transaction, use the Complete-Transaction<\/b> cmdlet. You can then use the Get-Item<\/b> cmdlet to see if the new registry key has been created. This is seen here:<\/p>\n

PS C:> Complete-Transaction
PS C:> Get-Item HKCU:SoftwareScriptingGuystest2<\/p>\n

    <\/span>Hive: HKEY_CURRENT_USERSoftwareScriptingGuys<\/p>\n

SKC  <\/span>VC Name                           <\/span>Property
—  <\/span>— —-                           <\/span>——–
  <\/span>0   <\/span>1 test2                          <\/span>{(default)}<\/p>\n

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

SK, because you specifically mentioned remote registry operations, you first need to create a remote Windows PowerShell session. To do this, use the Enter-PSSession<\/b> cmdlet and specify the computer name. This is shown here:<\/p>\n

PS C:> Enter-PSSession -ComputerName c2<\/p>\n

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

Next you need to start a transaction by using the Start-Transaction<\/b> cmdlet, and then change your working location to a registry drive. This is shown here:<\/p>\n

[c2]: PS C:> Start-Transaction
[c2]: PS C:> sl hkcu:<\/p>\n

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

After you have moved to the new location, use the New-Item<\/b> cmdlet to create a new registry key. Remember, you must use the –UseTransaction<\/b> switched parameter, or the registry key will be created immediately. This is shown here:<\/p>\n

[c2]: PS HKCU:> New-Item ScriptingGuys -UseTransaction<\/p>\n

    <\/span>Hive: HKEY_CURRENT_USER<\/p>\n

SKC  <\/span>VC Name                           <\/span>Property
—  <\/span>— —-                           <\/span>——–
  <\/span>0   <\/span>0 ScriptingGuys                  <\/span>{}<\/p>\n


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

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

If you would like to confirm that the registry key has been accepted, and you would like to see what the change will be when the transaction is completed, use the Get-Item<\/b> cmdlet with the –UseTransaction<\/b> switched parameter. This will show you the results after the transaction is completed. This is seen here:<\/p>\n


[c2]: PS HKCU:> Get-Item ScriptingGuys -UseTransaction<\/p>\n

    <\/span>Hive: HKEY_CURRENT_USER<\/p>\n

SKC  <\/span>VC Name                           <\/span>Property
—  <\/span>— —-                           <\/span>——–
  <\/span>0   <\/span>0 ScriptingGuys                  <\/span>{}<\/p>\n


<\/p>\n

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

To complete the transaction, use the Complete-Transaction<\/b> cmdlet, and exit from the remote Windows PowerShell session. This is shown here:<\/p>\n


[c2]: PS HKCU:> Complete-Transaction
[c2]: PS HKCU:> exit
PS C:><\/p>\n

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

Using the registry editor on the remote computer (via Remote Desktop on Hyper-V), you will see that the registry key was created under the hive of the remote user (in this case nwtradersed). On the remote machine, the nwtradersadministrator is logged in. Therefore, it is necessary to browse to the HKCU for the nwtradersed user. This is shown in the following image. <\/p>\n

\"Image<\/p>\n

\n

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

SK, that is all there is to using a transaction to create a local registry key and remote registry key. Join us tomorrow when we will talk about…wait a minute… <\/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 us 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 have been using Windows PowerShell to manipulate the registry since Windows PowerShell 1.0 came out. With Windows PowerShell 2.0, I can now edit the registry on a remote computer. How can I use transactions with the registry provider so that I can ensure that my changes to the registry […]<\/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,4,45],"class_list":["post-51213","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-getting-started","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":"

    Hey, Scripting Guy! I have been using Windows PowerShell to manipulate the registry since Windows PowerShell 1.0 came out. With Windows PowerShell 2.0, I can now edit the registry on a remote computer. How can I use transactions with the registry provider so that I can ensure that my changes to the registry […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/51213","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=51213"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/51213\/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=51213"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=51213"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=51213"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}