In a galaxy very, very near to here, when you are not cleaning-up droids, you administer a DHCP infrastructure in Windows Server 2003 with two servers in a split scope<\/a> configuration. Because extended support for Windows Server 2003 ends on the July 14, 2015, you’ve read about the new features in Windows Server 2012, and you want some DHCP failover goodness! (For more information, see Step-by-Step: Configure DHCP for Failover<\/a>.)<\/p>\n So…how do you seamlessly<\/b> migrate your current DHCP infrastructure, combining the split scopes into a load-balanced failover relationship? And how, on a desert-planet-in-a-binary-star-system, can the PowerShell help out?<\/p>\n I’ll answer with an example migration process:<\/p>\n Figure 1<\/b> Migration overview<\/p>\n Windows PowerShell is what gives scripters their power. You must learn the ways of the PowerShell if you are to implement a DHCP infrastructure in Windows Server 2012. Let’s begin our scripter training by looking at the first two migration steps…<\/p>\n The migration tools you are looking for are the Windows PowerShell-based Windows Server Migration Tools. They are awesome! Need I say more? Well, yes…<\/p>\n On each of the servers running Windows Server 2003, the Windows Server Migration Tools capture the DHCP configuration as separate images. Each image is then imported to the corresponding DHCP server running Windows Server 2012. No need to worry about transferring from a 32-bit host to a 64-bit host. Apart from some initial configuration, it’s as simple as that!<\/p>\n Here’s how you list the features available for export on the source servers:<\/p>\n Get-SmigServerFeature<\/p>\n For example:<\/p>\n Here’s a sample export command:<\/p>\n Export-SmigServerSetting -FeatureID "DHCP" -Path "c:\\smig_export_dhcp" -Verbose<\/p>\n And here’s a sample import command for the target servers:<\/p>\n Import-SmigServerSetting -FeatureID "DHCP" -Path "c:\\smig_import_dhcp" -Verbose -Force<\/p>\n Note<\/b> Add the DHCP server role to the servers running Windows Server 2012 before you import the migration image to ensure that the management tools are present.<\/p>\n For more information about the initial configuration of the Windows Server Migration Tools, see Install, Use, and Remove Windows Server Migration Tools<\/a>.<\/span><\/p>\n Are you a little short on DHCP server comparison script? On with the scripter training…<\/p>\n Before you add DHCP host servers to a failover relationship, it’s good practice to ensure that the server settings are consistent. I wrote a script to produce an Excel report that highlights discrepancies between two DHCP servers. You can download it here: Compare DHCP Server Settings with PowerShell DHCP Cmdlets<\/a>.<\/p>\n The script performs a number of checks, and the results of each test are written to a separate worksheet.<\/p>\n How do we generate the report content? Use Windows PowerShell, young scriptwalker!<\/p>\n There are 103 cmdlets in the DHCP server module for Windows PowerShell, which was introduced with Windows Server 2012 and Windows PowerShell 3.0. The script uses 10 of these cmdlets to jump to hyperspace to compare server settings:<\/p>\n The Compare_DHCP_Server_Settings.ps1 script has a “control panel” (as shown in Figure 2) to determine which checks are included when the script is executed.<\/p>\n Figure 2<\/b> Control panel used by script<\/p>\n Hmmm, if only my script control panel looked more like the one in Figure 3!<\/p>\n Figure 3<\/b> Dream control panel<\/p>\n Where was I? Oh, yes…<\/p>\n Scripter training. Each of the included checks is executed against the two DHCP server names that were passed as script parameters.<\/p>\n The checks are part of an array that is looped through $Checks<\/b>. A Switch<\/b> statement is used to evaluate each iterated check. Why? Some of the cmdlets return a single object; some cmdlets return multiple objects. A different function is used to perform the object comparison in each of these scenarios.<\/p>\n ForEach ($Check in $Checks) {<\/p>\n Switch ($Check) {<\/p>\n "DhcpServerAuditLog" {$Single = $True}<\/p>\n "DhcpServerv4Class" {$Single = $False; $ComparisonProperty = "Name"}<\/p>\n Where a cmdlet returns a single object, $Single<\/b> is set to True. Where a cmdlet returns multiple objects, $Single<\/b> is False, and a common comparison property for the resultant objects is defined (more about this later).<\/p>\n With the current check matched by Switch<\/b>, $Single<\/b> is tested to define the function to call. The test also determines what parameter values get passed to the function by a technique called splatting. If you’ve not seen splatting before, it’s used to pass parameter values as a single entity (use Get-Help<\/b> to find more about splatting).<\/p>\n In the script, the splatted parameter values are defined in a hash table.<\/p>\n If ($Single) {<\/p>\n #Splatted parameters<\/p>\n $Parameters = @{<\/p>\n DhcpCmdlet = "Get-$Check"<\/p>\n DhcpServer1 = $DhcpServer1<\/p>\n DhcpServer2 = $DhcpServer2<\/p>\n SheetNumber = $i<\/p>\n SheetName = $Check<\/p>\n } #End of $Parameters<\/p>\n #Target function<\/p>\n $Function = "Compare-SingleObject"<\/p>\n } #End of If ($Single)…<\/p>\n Where $Single<\/b> is false, an additional property is added to the splatted parameters. This is the $ComparisonProperty<\/b> mentioned earlier:<\/p>\n Else {<\/p>\n #Splatted parameters<\/p>\n $Parameters = @{<\/p>\n DhcpCmdlet = "Get-$Check"<\/p>\n DhcpServer1 = $DhcpServer1<\/p>\n DhcpServer2 = $DhcpServer2<\/p>\n SheetNumber = $i<\/p>\n SheetName = $Check<\/p>\n ComparisonProperty = $ComparisonProperty<\/p>\n } #End of $Parameters<\/p>\n #Target function<\/p>\n $Function = "Compare-MultipleObjects"<\/p>\n } #End of Else ($Single)…<\/p>\n With $Parameters<\/b> and $Function<\/b> defined, the comparison check is executed:<\/p>\n &$Function @Parameters<\/p>\n There are two things to note here. The first is the use of the call operator, &<\/b>, to invoke the stored function. Without this, Compare-SingleObject<\/b> or Compare-MultipleObjects<\/b> are returned as strings. The second is that $Parameters<\/b> becomes @Parameters<\/b>. @ <\/b>means splat!<\/p>\n The Compare-SingleObject<\/b> function calls the current check, $DhcpCmdlet<\/b>, against each DHCP server and stores the results in a variable:<\/p>\n $Output1 = &$DhcpCmdlet -ComputerName $DhcpServer1<\/p>\n $Output2 = &$DhcpCmdlet -ComputerName $DhcpServer2<\/p>\n A list of property names for the resultant object type is then retrieved:<\/p>\n $Properties = ($Output1[0] | Get-Member -Type Properties).Name <\/p>\n Each property from each server is compared:<\/p>\n ForEach ($Property in $Properties) {<\/p>\n $Result = Compare-Object -ReferenceObject $Output1 -DifferenceObject $Output2 -IncludeEqual -Property $Property<\/p>\n If they don’t match, the property name in the Excel report is marked as red:<\/p>\n If ($Result.SideIndicator -ne "==") {<\/p>\n $ExcelSheet.Cells.Item($j,1).Interior.ColorIndex = 3<\/p>\n } #End of If ($Result.SideIndicator -ne "==")<\/p>\n Compare-MultipleObjects<\/p>\n The Compare-MultipleObejcts<\/b> function takes an extra parameter—a comparison property for the DHCP cmdlet executed. Here’s how the function works…<\/p>\n As with the Compare-SingleObject<\/b> function, the check is executed against both servers, and a list of property names for the resultant objects are stored in a variable. This time the returned array of objects are compared with the aid of the comparison property. It is important that the selected $ComparisonProperty<\/b> always have a value.<\/p>\n $Comparison = Compare-Object -ReferenceObject $Output1 -DifferenceObject $Output2 -IncludeEqual -Property $ComparisonProperty<\/p>\n Now, we need to deal with the fact that some objects might be on both servers, some objects on only the first DHCP server, and some objects on only the second DHCP server.<\/p>\n To check for objects present on both servers, test for the equals indicator, ==<\/b>, from the comparison results:<\/p>\n If ($Comparison.SideIndicator -Contains "==") {<\/p>\n Where objects are present on both servers, write the details to a $Results<\/b> variable, and continue to use the comparison property as the common reference:<\/p>\n $Results = $Comparison | Where-Object {$_.SideIndicator -eq "=="} | Select $ComparisonProperty<\/p>\n Loop through each mutual object and rerun the current check again against a specific iteration of $Result.$ComparisonProperty<\/b> on both servers:<\/p>\n ForEach ($Result in $Results) {<\/p>\n $Value1 = &$DhcpCmdlet $Result.$ComparisonProperty -ComputerName $DhcpServer1<\/p>\n $Value2 = &$DhcpCmdlet $Result.$ComparisonProperty -ComputerName $DhcpServer2<\/p>\n Then, as with Compare-SingleObject<\/b>, loop through each of the object’s properties and compare the value from each server. Highlight discrepancies in red, for example:<\/p>\n Next, check for objects that are present only on the first DHCP server. Test for the left side indicator (<=<\/b>):<\/p>\n If ($Comparison.SideIndicator -Contains "<=") {<\/p>\n Run the current DHCP cmdlet against the first DHCP server:<\/p>\n $Value1 = &$DhcpCmdlet $Result.$ComparisonProperty -ComputerName $DhcpServer1<\/p>\n Loop through the properties and write them to the report. Highlight the Excel cells in green:<\/p>\n $ExcelSheet.Cells.Item($k,2).Interior.ColorIndex = 43<\/p>\n Finally, the check for objects that are present on only the second DHCP server has almost identical script to the first server check, except you are testing for the right-side indicator:<\/p>\n If ($Comparison.SideIndicator -Contains "=>") {<\/p>\n Loop through the properties, and write them to the report. Highlight the Excel cells in orange:<\/p>\n $ExcelSheet.Cells.Item($j,3).Interior.ColorIndex = 44<\/p>\n Upon completion, you’ll have an Excel spreadsheet in the same folder as the script, which is saved in the following format:<\/p>\n <YearMonthDayHourMinuteSecond>_<DhcpServer1>_<DhcpServer2>_DHCP_Server_Comparison.xls<\/p>\n Analyse the report and perform appropriate configuration changes to bring the servers in line. Pay particular attention to classes, option definitions, and option values. And please let me know if you spot a two meter-wide exhaust port!<\/p>\n Well, that’s it for Episode 1. Sadly, there are no huge explosions or fancy award ceremonies to finish with. However, our DHCP data from our server running Windows Server 2003 is now seamlessly migrated to our DHCP servers running Windows Server 2012, and we’ve compared and corrected any errant settings. In Episode 2, we’ll complete our scripter training and the migration process.<\/p>\n May the PowerShell be with you!<\/p>\n ~Ian<\/p>\n Thanks, Ian! Our DHCP migration lesson will continue tomorrow with Ian returning to conclude his series.<\/p>\n I invite you to follow me on Twitter<\/a> and Facebook<\/a>. If you have any questions, send email to me at scripter@microsoft.com<\/a>, or post your questions on the Official Scripting Guys Forum<\/a>. See you tomorrow. Until then, peace.<\/p>\n Ed Wilson, Microsoft Scripting Guy<\/b> <\/p>\n","protected":false},"excerpt":{"rendered":" Summary: Microsoft PFE, Ian Farr, talks about using Windows PowerShell to migrate DHCP servers. Microsoft Scripting Guy, Ed Wilson, is here. Today we welcome back guest blogger, Ian Farr. Episode 1: A New Hope In a galaxy very, very near to here, when you are not cleaning-up droids, you administer a DHCP infrastructure in Windows […]<\/p>\n","protected":false},"author":596,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[218,56,472,37,3,45],"class_list":["post-1947","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-dhcp-server","tag-guest-blogger","tag-ian-farr","tag-networking","tag-scripting-guy","tag-windows-powershell"],"acf":[],"blog_post_summary":" Summary: Microsoft PFE, Ian Farr, talks about using Windows PowerShell to migrate DHCP servers. Microsoft Scripting Guy, Ed Wilson, is here. Today we welcome back guest blogger, Ian Farr. Episode 1: A New Hope In a galaxy very, very near to here, when you are not cleaning-up droids, you administer a DHCP infrastructure in Windows […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/1947","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\/596"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=1947"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/1947\/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=1947"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=1947"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=1947"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-2-24-14-1.png\" "\\"Image")
<\/a><\/p>\nEpisode 1: A New Hope<\/h2>\n
\n
![\"Image](\"https:\/\/msdnshared.blob.core.windows.net\/media\/TNBlogsFS\/prod.evol.blogs.technet.com\/CommunityServer.Blogs.Components.WeblogFiles\/00\/00\/00\/76\/18\/Capture.PNG\" "\\"Image")
<\/a>
<\/b><\/p>\n![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-2-24-14-2.jpg\" "\\"Image")
<\/p>\nStep 1: Migration tools<\/h2>\n
![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-2-24-14-3.png\" "\\"Image")
<\/a><\/p>\nStep 2: DHCP server comparison script<\/h2>\n
\n
![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-2-24-14-4.png\" "\\"Image")
<\/a><\/p>\n\n
DHCP server module for Windows PowerShell<\/h3>\n
\n
![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/7752.hsg-2-24-14-5.png\" "\\"Image")
<\/a><\/b><\/p>\n![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-2-24-14-6.png\" "\\"Image")
<\/a><\/p>\n![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-2-24-14-7.png\" "\\"Image")
<\/a><\/p>\n![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-2-24-14-8.png\" "\\"Image")
<\/a><\/p>\n![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-2-24-14-9.png\" "\\"Image")
<\/a> <\/p>\n