{"id":16001,"date":"2011-01-05T00:01:00","date_gmt":"2011-01-05T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2011\/01\/05\/simplify-desktop-configuration-by-using-a-shared-powershell-module\/"},"modified":"2011-01-05T00:01:00","modified_gmt":"2011-01-05T00:01:00","slug":"simplify-desktop-configuration-by-using-a-shared-powershell-module","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/simplify-desktop-configuration-by-using-a-shared-powershell-module\/","title":{"rendered":"Simplify Desktop Configuration by Using a Shared PowerShell Module"},"content":{"rendered":"

 <\/span> <\/span>\nSummary:<\/span><\/b> Simplify your desktop configuration needs by using a Windows PowerShell module stored on a central file share.<\/span>\n <\/span>\n\"Hey,<\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span>Hey, Scripting Guy! I enjoy using Windows PowerShell modules. I think they are way cool. The thing is, I am not too keen on deploying them to remote workstations. What would be great is if there was a way that I could use a module that was stored on a central server. Is that possible?<\/span>\n— MT<\/span>\n <\/span>\n\"Hey,<\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span>Hello MT, Microsoft Scripting Guy Ed Wilson here. Well, today is a cool day—both literally and figuratively. The weather bit is not unusual, it is January after all, but when the weekend temperatures reached 65 degrees Fahrenheit (18 degrees Celsius) I was hoping that winter was over. The cool (figuratively) part about today is that I am going to speak to the Northern Colorado SharePoint Users Group this evening (via Live Meeting<\/a>). I have been to Denver several times teaching Windows PowerShell workshops to Microsoft Premier Customers but have not been outside of the city. Tonight I will correct that (at least virtually). <\/span>\nUtilizing a module from a central file share is no different than using a module from one of the two default locations. When a module is placed in the %windir%System32WindowsPowerShellv1.0Modules<\/b> folder is available to all users. If a module is placed in the %UserProfile%My documentsWindowsPowerShellModules<\/b> folder it is only available to the specific user. The advantage of placing modules in the %UserProfile%<\/b> location is the user automatically has permission to perform the installation, whereas system location requires Administrator rights on Windows Vista and later. <\/span>\nSpeaking of installation of Windows PowerShell modules, in many cases the installation of a Windows PowerShell module is no more complicated than placing the *.psm1<\/b> file in a folder in default user location. The key point is that the folder that is created under the Modules<\/b> folder must have the same name as the module name itself. When installing modules on a local computer, I use my Copy-Modules.ps1 script<\/a>. <\/span>\nWhen I copy a Windows PowerShell module to a network shared location, I follow the same rules. I make sure that the folder that contains the module is the same name as the module name. As an example, I am going to copy my conversion module to a shared drive on one of my Windows Server 2008 R2 Hyperv servers (I am using this shared drive because I already have it shared out on my local network). The module I will use is the same one that I developed during the first Weekend Scripter<\/a> articles—the ConversionModuleV6<\/b> module. As seen here, that module is now shared out (there are also process snapshots stored in XML from a previous Weekend Scripter article<\/a>). <\/span><\/p>\n

PS C:> dir \\hyperv-boxshared<\/span><\/span><\/p>\n

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

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

    <\/span>Directory: \\hyperv-boxshared<\/span><\/span><\/p>\n

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

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

Mode                <\/span>LastWriteTime     <\/span>Length Name<\/span><\/span><\/p>\n

—-                <\/span>————-     <\/span>—— —-<\/span><\/span><\/p>\n

d—-          <\/span>1\/4\/2011   <\/span>3:53 PM            <\/span>ConversionModuleV6<\/span><\/span><\/p>\n

-a—        <\/span>12\/13\/2010   <\/span>3:12 PM         <\/span>32 bios.ps1<\/span><\/span><\/p>\n

-a—        <\/span>12\/13\/2010   <\/span>2:45 PM       <\/span>1086 Get-SharedFolders.ps1<\/span><\/span><\/p>\n

-a—        <\/span>12\/26\/2010   <\/span>9:24 PM    <\/span>8344438 Process1_BIGT-PC.xml<\/span><\/span><\/p>\n

-a—          <\/span>1\/4\/2011  <\/span>10:45 AM    <\/span>9547600 Process1_MRED1.xml<\/span><\/span><\/p>\n

-a—        <\/span>10\/12\/2010  <\/span>11:37 AM    <\/span>9272696 Process1_TERESA-WIN7.xml<\/span><\/span><\/p>\n

-a—          <\/span>1\/4\/2011   <\/span>4:12 PM    <\/span>6448040 Process1_WIN7-C1.xml<\/span><\/span><\/p>\n

-a—        <\/span>12\/26\/2010   <\/span>9:26 PM   <\/span>10451674 Process2_BIGT-PC.xml<\/span><\/span><\/p>\n

-a—          <\/span>1\/4\/2011  <\/span>10:46 AM    <\/span>9153432 Process2_MRED1.xml<\/span><\/span><\/p>\n

-a—        <\/span>10\/12\/2010  <\/span>11:38 AM   <\/span>11106128 Process2_TERESA-WIN7.xml<\/span><\/span><\/p>\n

-a—          <\/span>1\/4\/2011   <\/span>4:13 PM    <\/span>6897914 Process2_WIN7-C1.xml<\/span><\/span><\/p>\n

-a—        <\/span>12\/26\/2010   <\/span>9:27 PM   <\/span>10283808 Process3_BIGT-PC.xml<\/span><\/span><\/p>\n

-a—          <\/span>1\/4\/2011  <\/span>10:47 AM    <\/span>9141224 Process3_MRED1.xml<\/span><\/span><\/p>\n

-a—        <\/span>10\/12\/2010  <\/span>11:39 AM   <\/span>11489310 Process3_TERESA-WIN7.xml<\/span><\/span><\/p>\n

-a—          <\/span>1\/4\/2011   <\/span>4:15 PM    <\/span>7521712 Process3_WIN7-C1.xml<\/span><\/span><\/p>\n

-a—        <\/span>12\/26\/2010   <\/span>9:29 PM   <\/span>10163664 Process4_BIGT-PC.xml<\/span><\/span><\/p>\n

-a—          <\/span>1\/4\/2011  <\/span>10:49 AM    <\/span>9066674 Process4_MRED1.xml<\/span><\/span><\/p>\n

-a—        <\/span>10\/12\/2010  <\/span>11:41 AM   <\/span>12156950 Process4_TERESA-WIN7.xml<\/span><\/span><\/p>\n

-a—          <\/span>1\/4\/2011   <\/span>4:16 PM    <\/span>7767062 Process4_WIN7-C1.xml<\/span><\/span><\/p>\n

-a—         <\/span>7\/12\/2010  <\/span>12:06 PM     <\/span>728046 ScriptingGuysWallPaper.jpg<\/span><\/span><\/p>\n

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

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

PS C:><\/span><\/span>\n <\/span>\nTo import the module from the shared location, I include the path to the module. As seen here, I can even use wildcards for the module name.<\/span><\/p>\n

Import-Module \\hyperv-boxsharedconv*<\/span><\/span>\n <\/span>\nTo see if the module has loaded, I use the Get-Module<\/b> Windows PowerShell cmdlet. As seen here, the ConversionModuleV6<\/b> is the only module currently loaded on my computer and the path confirms that it loaded from the network location.<\/span><\/p>\n

PS C:> Get-Module | format-list *<\/span><\/span><\/p>\n

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

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

ExportedCommands    <\/span>: {ConvertTo-Feet, ConvertTo-Miles, ConvertTo-MetersPerSecond, C<\/span><\/span><\/p>\n

                      <\/span>onvertTo-Pounds…}<\/span><\/span><\/p>\n

Name                <\/span>: ConversionModuleV6<\/span><\/span><\/p>\n

Path                <\/span>: \\hyperv-boxsharedConversionModuleV6ConversionModuleV6.psm1<\/span><\/span><\/p>\n

Description         <\/span>:<\/span><\/span><\/p>\n

Guid                <\/span>: 00000000-0000-0000-0000-000000000000<\/span><\/span><\/p>\n

ModuleBase          <\/span>: \\hyperv-boxsharedConversionModuleV6<\/span><\/span><\/p>\n

PrivateData         <\/span>:<\/span><\/span><\/p>\n

Version             <\/span>: 0.0<\/span><\/span><\/p>\n

ModuleType          <\/span>: Script<\/span><\/span><\/p>\n

AccessMode          <\/span>: ReadWrite<\/span><\/span><\/p>\n

ExportedFunctions   <\/span>: {[ConvertTo-celsius, ConvertTo-celsius], [ConvertTo-Fahrenheit<\/span><\/span><\/p>\n

                      <\/span>, ConvertTo-Fahrenheit], [ConvertTo-Feet, ConvertTo-Feet], [Co<\/span><\/span><\/p>\n

                      <\/span>nvertTo-Kilometers, ConvertTo-Kilometers]…}<\/span><\/span><\/p>\n

ExportedCmdlets     <\/span>: {}<\/span><\/span><\/p>\n

NestedModules       <\/span>: {}<\/span><\/span><\/p>\n

RequiredModules     <\/span>: {}<\/span><\/span><\/p>\n

ExportedVariables   <\/span>: {}<\/span><\/span><\/p>\n

ExportedAliases     <\/span>: {[CTCS, CTCS], [CTFH, CTFH], [CTFT, CTFT], [CTKM, CTKM]…}<\/span><\/span><\/p>\n

SessionState        <\/span>: System.Management.Automation.SessionState<\/span><\/span><\/p>\n

OnRemove            <\/span>:<\/span><\/span><\/p>\n

ExportedFormatFiles : {}<\/span><\/span><\/p>\n

ExportedTypeFiles   <\/span>: {}<\/span><\/span><\/p>\n

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

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

PS C:><\/span><\/span>\n <\/span>\nMT, you need to keep a couple of things in mind. The first thing is that a Windows PowerShell module is basically a script (in our particular application) and that the Script Execution policy must be set so that script execution is permitted. If the script execution policy is set to the default level of restricted<\/i> an error will be generated (even if the logged on user is an Administrator). Fortunately, the error that is returned informs one of that fact. Even if the execution policy is set to restricted <\/i>on a particular machine, you can always run a Windows PowerShell script (or module) if you start Windows PowerShell with the bypass<\/i> option. The command to do this is seen here.<\/span><\/p>\n

powershell -executionpolicy bypass<\/span><\/span>\n <\/span>\nOne of the really cool uses of a shared module is to permit centralization of Windows PowerShell Profile<\/a><\/span>s<\/span><\/span> for networked users. To do this, the profile on the local computer would simply import the shared module. In this way, I only need to modify one module in one location to permit updates for all the users on the network. I talked about using a module to simplify a Windows PowerShell ISE Profile<\/a> in the Weekend Scripter: Clean up your PowerShell ISE Profile by using a Module<\/a> post.<\/span><\/p>\n

 <\/span><\/span>\nMT, that is all there is to using a module from a centralized file share. Storage of scripts week will continue tomorrow when I will talk about logon scripts. <\/span>\nI invite you to follow me on Twitter<\/a> or Facebook<\/a>. If you have any questions, send email to me at scripter@microsoft.com<\/a> or post them on the Official Scripting Guys Forum<\/a>. See you tomorrow. Until then, peace.<\/span>\n <\/span>\nEd Wilson, Microsoft Scripting Guy<\/span><\/b> <\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

   Summary: Simplify your desktop configuration needs by using a Windows PowerShell module stored on a central file share.   Hey, Scripting Guy! I enjoy using Windows PowerShell modules. I think they are way cool. The thing is, I am not too keen on deploying them to remote workstations. What would be great is if […]<\/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,52,3,4,45],"class_list":["post-16001","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-getting-started","tag-modules","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":"

   Summary: Simplify your desktop configuration needs by using a Windows PowerShell module stored on a central file share.   Hey, Scripting Guy! I enjoy using Windows PowerShell modules. I think they are way cool. The thing is, I am not too keen on deploying them to remote workstations. What would be great is if […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/16001","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=16001"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/16001\/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=16001"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=16001"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=16001"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}