{"id":502,"date":"2014-10-23T00:01:00","date_gmt":"2014-10-23T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2014\/10\/23\/my-path-to-a-powershell-4-0-upgrade\/"},"modified":"2014-10-23T00:01:00","modified_gmt":"2014-10-23T00:01:00","slug":"my-path-to-a-powershell-4-0-upgrade","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/my-path-to-a-powershell-4-0-upgrade\/","title":{"rendered":"My Path to a PowerShell 4.0 Upgrade"},"content":{"rendered":"

Summary<\/b>: Microsoft IIS MVP, Terri Donahue, talks about her path to upgrading to Windows PowerShell 4.0.<\/span><\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. Welcome new guest blogger, Terri Donahue.<\/p>\n

Microsoft IIS MVP, Terri Donahue is a systems administrator who has been supporting Internet Information Services (IIS) since version 4.0. Through the years, she has had extensive hands-on experience with many web servers including Lotus Domino, Apache, and of course, IIS. She has a passion for helping people solve technology-related problems. She is focusing on improving her Windows PowerShell skills. She regularly attends the Charlotte PowerShell User Group and volunteers at PowerShell Saturday in Charlotte.<\/p>\n

Take it away, Terri…<\/p>\n

Windows PowerShell 4.0 is backward-compatible with Windows PowerShell 3.0 and Windows PowerShell 2.0. This means that upgrading to Windows PowerShell 4.0 should not be governed by the necessity to maintain multiple versions of scripts for the different versions of Windows PowerShell. The decision should be determined by the new features that PowerShell 4.0 can provide. Windows PowerShell 2.0 brought us remoting, and Windows PowerShell 3.0 brought us IntelliSense and lots of new cmdlets. As everyone has heard, Desired State Configuration (DSC), is the biggest addition to Windows PowerShell 4.0.<\/p>\n

However, there are more new features in Windows PowerShell 4.0 than DSC. The Save-Help<\/b> cmdlet can come in very handy for downloading a local copy of Help for a given module or modules for use on a computer that doesn’t have Internet access. I imagine this will be a bigger plus than is originally realized—as the offline Web PI command-line utility has been.<\/p>\n

One thing to note is that upgrading to Windows PowerShell 4.0 does not ensure that all the new cmdlets will work exactly the same on the upgraded systems. This is the same issue that I encountered when I installed Windows Framework 3.0 on Windows Server 2008 R2. A script that correctly queried a certificate property on my computer running Windows 8 (native Windows PowerShell 3.0) returned the same status code regardless of the setting of the property on a server that had been upgraded to WMF 3.0. <\/span><\/p>\n

To ensure that it was an operating system dependency rather than an issue with the cmdlet, I used the old school method of querying with crypt32.dll rather than the Windows PowerShell cmdlet. Both methods had the same results on the upgraded server running Windows Server 2008 R2.<\/span><\/p>\n

I am an administrator who hacks around at script, including Windows PowerShell writing, so being able to debug my script is a necessity. The debugger has also been enhanced in Windows PowerShell 4.0. It now allows for debugging a script running on a remote computer, and it even preserves the debugging session when the remote session is disconnected and later reconnected.<\/p>\n

Based on my research, I decided to upgrade my servers running Windows Server 2012 and Windows Server 2008 R2 to Windows PowerShell 4.0.<\/p>\n

On a computer running Windows 8.1, there are 548 cmdlets. On a server running Windows Server 2012 R2, there are 693 cmdlets. As you can see from the following table, the number of cmdlets is greatly reduced when you perform an upgrade to a given Windows PowerShell version on a different operating system compared to the native installation on a computer. Therefore, that should not be the driving factor behind deciding to upgrade.<\/p>\n\n\n\n\n\n
\n

  <\/span>Server version<\/b><\/p>\n<\/td>\n

\n

  <\/span>Cmdlets with WMF 3.0<\/b><\/p>\n<\/td>\n

\n

  C<\/span>mdlets with WMF 4.0<\/b><\/p>\n<\/td>\n<\/tr>\n

\n

  <\/span>Windows Server 2008 R2<\/p>\n<\/td>\n

\n

  <\/span>313<\/p>\n<\/td>\n

\n

  <\/span>317<\/p>\n<\/td>\n<\/tr>\n

\n

  <\/span>Windows Server 2012<\/p>\n<\/td>\n

\n

  <\/span>440<\/p>\n<\/td>\n

\n

  <\/span>444<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Be sure to read and follow the steps to install WMF 4.0 on your given operating system. I had no problem on my server running Windows Server 2008 R2, but on the server running Windows Server 2012, I kept running into this error message:<\/p>\n

Windows update could not be installed because of error 2148098050 "The certificate for the signer of the message is invalid or not found."<\/b><\/p>\n

The fix was to download the correct installer, which to me was not apparent. The the selected check box next to the installer name in the following image shows the correct installer for Windows Server 2012:<\/p>\n

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

The Windows8-RT<\/b> naming convention was what threw me off. I kept trying to install the Windows6.1-KB2819745-x64.MultiPkg.msu<\/b> package. In addition, I went so far as to install Windows Identity Foundation 3.5, which was referenced in many resolution articles—before I actually read the following steps in the release notes for Windows 2012:<\/p>\n

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

Sometimes, even some of us nerdy types need to be reminded to RTFM!<\/p>\n

After the upgrade, I decided to play around with DSC some because I hadn’t seen it in action nor tried it. There were some frustrations when I was trying to get it to work as documented on a couple sites that I tried. I could not get it to create the .mof file, regardless of what I did. I went through a couple steps on the server running Windows Server 2012, and that still did not help. For example, I installed IIS and many of the features that I wanted to set up using DSC. I then installed Windows PowerShell Desired State Configuration (thinking that was the missing piece).<\/p>\n

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

The step that I had been missing was actually running the configuration from the Windows PowerShell ISE. This loaded the configuration in the session. This is the same as running a function to initialize it before use. This is a configuration that installs all of the features I use in my IIS setups to ensure that certain components are available and ready for use:<\/p>\n

Configuration TestWebsite<\/p>\n

{<\/p>\n

    param ($MachineName)<\/p>\n

 <\/p>\n

    Node $MachineName<\/p>\n

    {<\/p>\n

        #Install the IIS Role<\/p>\n

        WindowsFeature IIS<\/p>\n

        {<\/p>\n

        Ensure = "Present"<\/p>\n

        Name = "Web-Server"<\/p>\n

        }<\/p>\n

 <\/p>\n

        #Install ASP.NET 4.5<\/p>\n

        WindowsFeature ASP<\/p>\n

        {<\/p>\n

        Ensure = "Present"<\/p>\n

        Name = "Web-Asp-Net45"<\/p>\n

        }<\/p>\n

 <\/p>\n

        #Install Request Monitor<\/p>\n

        WindowsFeature Request<\/p>\n

        {<\/p>\n

        Ensure = "Present"<\/p>\n

        Name = "Web-Request-Monitor"<\/p>\n

        }       <\/p>\n

 <\/p>\n

        #Install ODBC Logging – required for SMTP Server logging<\/p>\n

        WindowsFeature ODBC<\/p>\n

        {<\/p>\n

        Ensure = "Present"<\/p>\n

        Name = "Web-ODBC-Logging"<\/p>\n

        }<\/p>\n

 <\/p>\n

        #Install Tracing – enables FRT<\/p>\n

        WindowsFeature Tracing<\/p>\n

        {<\/p>\n

        Ensure = "Present"<\/p>\n

        Name = "Web-HTTP-Tracing"<\/p>\n

        }<\/p>\n

 <\/p>\n

        #Install ASP.Net 3.5<\/p>\n

        WindowsFeature ASP35<\/p>\n

        {<\/p>\n

        Ensure = "Present"<\/p>\n

        Name = "Web-ASP-Net"<\/p>\n

        }<\/p>\n

    }<\/p>\n

} <\/p>\n

As an explanation, each WindowsFeature<\/b> designation installs the corresponding role or feature. This configuration installs the following features:<\/p>\n