RG050 – The Printer Migration tool

By Max Ranzau

From the Completely and Utterly Unsupported Dept. This article covers a tool written by my good colleague Twan Dieltjes, one of our Kickass Developers. The purpose of the tool is to ease mass import of printers and shares from a CSV file, and produce buildingblocks ready to import in Workspace Manager. Yes, yes – it still says PowerFuse on the tin, but don’t be fooled, it works nicely on the latest builds. This tool can help you stand up an environment in no-time if you have a list of your printer queues already and/or printers defined in Active Directory.

Again, let me just state for the record that this tool is not supported by RES, Twan, Yours Truly, Domo Kun or anyone else. It’s provided AS IS. If you like it, be sure to comment below and perhaps the nice guys in the BatCave will share some more of their wonderful toys. (believe me, they have many!) Anyway the Printer Migration tool looks like this:


As you can see it can import network shares (to create drive mappings), but I don’t have an example CSV file for that part at the moment, so it will have to wait for an article update (update: now I have it, it’s at the bottom of the article). The Printer import however works pretty well. When you select it and hit next, you get to either import printers directly from Active Directory or from a CSV file (in this case), it looks like this:


An important note: Unless you prefer an empty buildingblock, you must select one or more printers using the checkboxes to the left. If you want to import all printers in one go, just hit the ‘Toggle selection‘ button. You can batch change all selected printers with the Override section. This one doesn’t do anything unless you hit the ‘Apply all to selection‘ button.

warning, yellowWarning: If you’re bats**t crazy enough to run an unsupported tool up against a production environment, at least be sure to take this opportunity to mark all the printers as disabled with the override selection.

On the next screen you configure the Access Control, which determines WHO will get the printer. Note that you cannot configure different access control for different printers. This isn’t necessary either as this is so much easier to do afterwards in the Access Control tab on the individual printers


As I usually assign network printers to Zones anyway, I have opted above to just assign all the printers to everyone. This tool doesn’t validate users so be careful if you use that part to get things right, as the WM2012 console doesn’t yet support Quick Edit on printers and other PowerLaunch items.

When you’ve got Access Control sorted, on the next screen hit the Create Buildingblock button to get your printer buildingblock. Job Done!

One more thing before I let you loose on the download. This tool has one more hidden feature up it’s sleeve. The import utility is able to attach managed printers to Zones as well. This is pretty cool as zones is preferably the management object of choice when doing location based printing (especially when the upcoming WM SR3 includes zone rules support for Wireless BSSID’s – shhh! :) Anyhoo, let’s have a look at the CSV file format:

\\TEST\TestPrinter;yes;;no;no;;;no;Description Test text;Both;{3465538D-21F8-43BB-9109-8F01ADDD986D};
\\FOO\BarPrinter;yes;;no;no;;;no;Description Foo Text;Both;{74C2538D-21F8-43C5-9109-8F01ADDD986D};
\\BAR\FooPrinter;yes;;no;no;;;no;Description Bar Text;Both;{81CBE425-13E4-403C-B531-D5301FB65483};

zone-guidThe field of interest here is the last one; GUIDPZ. This field is blank per default, but can contain a {GUID} for a Zone. If you put a valid Zone’s GUID in for one or more printers, those printers will automagically be attached to the referenced zone. The easiest place to pick up the GUID string for a given zone is in the WM console to open the Properties tab on a given zone and copy it from there.

Note that the tool currently seems to have a minor bug. If you assign Zone GUID’s to multiple printers, it appears the first one in the .CSV doesn’t get assigned. Anyway, it’s pretty cool as it is, so remember to post some praise comments, so the RES developers will share some more of their toys with us mere mortals :)

Click on the archive to download the tool:  Icon, RarFile

Update: I got hold of an example CSV file for using with the Network Share / Drivemapping feature in the tool. As you’ll note the CSV file doesn’t have any headers, it’s all in the order of the fields. The network share CSV file has been included in the .ZIP file above. When you import it in the Network share module of the migration tool, it looks like this:


Everything works pretty much the same way as with importing printers, however note that the driveletters do not have a colon after them.

Click here to download the example network share.CSV:  Excel Icon


1 Comment

  • By Hans Straat, September 30, 2013 @ 04:26

    We are currently experimenting with this tool to update RES WM with all networkprinters that can be used on our Xenapp 6.5 / RES WM environment wich is currently in testfase. Talking about 1200 printers and works like a charm with importing and keeping the GUID’s so all ‘new’ printers are left at Enabled=NO. This will save us time because we don’t have to add a printer in RES WM but just enable in and give the right access control permissions.

Other Links to this Post

RSS feed for comments on this post. TrackBack URI

Leave a comment

You must be logged in to post a comment.