v4.4.0

jdhitsolutions · jdhitsolutions · commit 46060a4eb32e · 2019-11-25T09:41:54.000-05:00
diff --git a/Configurations/Implement-Windows-Server-DHCP-2016/VMConfiguration.ps1 b/Configurations/Implement-Windows-Server-DHCP-2016/VMConfiguration.ps1
@@ -24,7 +24,7 @@ $credential = New-Object -typename Pscredential -ArgumentList Administrator, $se
 
 #region DSC Resources
 Import-DSCresource -ModuleName "PSDesiredStateConfiguration" -ModuleVersion "1.1"
-Import-DSCResource -modulename "xPSDesiredStateConfiguration" -ModuleVersion  "8.9.0.0"
+Import-DSCResource -modulename "xPSDesiredStateConfiguration" -ModuleVersion  "8.10.0.0"
 Import-DSCResource -modulename "xActiveDirectory" -ModuleVersion  "3.0.0.0"
 Import-DSCResource -modulename "xComputerManagement" -ModuleVersion  "4.1.0.0"
 Import-DSCResource -modulename "xNetworking" -ModuleVersion  "5.7.0.0"
diff --git a/Configurations/Implement-Windows-Server-DHCP-2016/VMConfigurationData.psd1 b/Configurations/Implement-Windows-Server-DHCP-2016/VMConfigurationData.psd1
@@ -204,9 +204,9 @@ WIN10_x86_Enterprise_LTSC_EN_Eval       Windows 10 32bit Enterprise LTSC 2019 En
                 @{ Name = 'xNetworking'; RequiredVersion = '5.7.0.0'; Provider = 'PSGallery'; },
                 @{ Name = 'xDhcpServer'; RequiredVersion = '2.0.0.0'; Provider = 'PSGallery'; },
                 @{ Name = 'xWindowsUpdate' ; RequiredVersion = '2.8.0.0'; Provider = 'PSGallery'; },
-                @{ Name = 'xPSDesiredStateConfiguration'; RequiredVersion = '8.9.0.0'; },
-                @{ Name = 'xPendingReboot'; RequiredVersion = '0.4.0.0'; },
-                @{ Name = 'xADCSDeployment'; RequiredVersion = '1.4.0.0'; }
+                @{ Name = 'xPSDesiredStateConfiguration'; RequiredVersion = '8.10.0.0'; Provider = 'PSGallery'; },
+                @{ Name = 'xPendingReboot'; RequiredVersion = '0.4.0.0'; Provider = 'PSGallery'; },
+                @{ Name = 'xADCSDeployment'; RequiredVersion = '1.4.0.0'; Provider = 'PSGallery'; }
             );
             Resource    = @(
                 @{
diff --git a/Configurations/Jason-DSC-Env/VMConfiguration.ps1 b/Configurations/Jason-DSC-Env/VMConfiguration.ps1
@@ -29,7 +29,7 @@ Configuration AutoLab {
     Import-DSCResource -ModuleName 'xNetworking' -ModuleVersion '5.7.0.0'
     Import-DSCResource -ModuleName 'xDhcpServer' -ModuleVersion '2.0.0.0'
     Import-DSCResource -ModuleName 'xWindowsUpdate' -ModuleVersion '2.8.0.0'
-    Import-DSCResource -ModuleName 'xPSDesiredStateConfiguration' -ModuleVersion '8.9.0.0'
+    Import-DSCResource -ModuleName 'xPSDesiredStateConfiguration' -ModuleVersion '8.10.0.0'
     Import-DSCResource -ModuleName 'xPendingReboot' -ModuleVersion '0.4.0.0'
     Import-DSCResource -ModuleName 'xADCSDeployment' -ModuleVersion '1.4.0.0'
 
diff --git a/Configurations/Jason-DSC-Env/VMConfigurationData.psd1 b/Configurations/Jason-DSC-Env/VMConfigurationData.psd1
@@ -207,9 +207,9 @@ demonstrations and would need to be modified for your environment.
                 @{ Name = 'xNetworking'; RequiredVersion = '5.7.0.0'; Provider = 'PSGallery'; },
                 @{ Name = 'xDhcpServer'; RequiredVersion = '2.0.0.0'; Provider = 'PSGallery'; },
                 @{ Name = 'xWindowsUpdate' ; RequiredVersion = '2.8.0.0'; Provider = 'PSGallery'; },
-                @{ Name = 'xPSDesiredStateConfiguration'; RequiredVersion = '8.9.0.0'; },
-                @{ Name = 'xPendingReboot'; RequiredVersion = '0.4.0.0'; },
-                @{ Name = 'xADCSDeployment'; RequiredVersion = '1.4.0.0'; }
+                @{ Name = 'xPSDesiredStateConfiguration'; RequiredVersion = '8.10.0.0'; Provider = 'PSGallery'; },
+                @{ Name = 'xPendingReboot'; RequiredVersion = '0.4.0.0'; Provider = 'PSGallery'; },
+                @{ Name = 'xADCSDeployment'; RequiredVersion = '1.4.0.0'; Provider = 'PSGallery'; }
 
             );
             Resource    = @(
diff --git a/Configurations/MultiRole/Instructions.md b/Configurations/MultiRole/Instructions.md
@@ -5,10 +5,10 @@ If you were instructed to use that configuration, this one should work for you.
 
 The lab builds the following:
 
-* 1 DC (DC1)
-* 1 Server (S1)
-* 1 Nano (N1)
-* 1 Client with RSAT (Cli1)
+* 1 DC (DC1 - Windows Server 2016 Core)
+* 1 Server (S1 - Windows Server 2016 Core)
+* 1 Nano (N1 - Windows Server 2016 Nano)
+* 1 Client with RSAT (Cli1 - Windows 10 Enterprise)
 
 ## To get started:
 
diff --git a/Configurations/PowerShellLab/VMConfiguration.ps1 b/Configurations/PowerShellLab/VMConfiguration.ps1
@@ -24,7 +24,7 @@ Configuration AutoLab {
 
     #region DSC Resources
     Import-DSCresource -ModuleName "PSDesiredStateConfiguration" -ModuleVersion "1.1"
-    Import-DSCResource -modulename "xPSDesiredStateConfiguration" -ModuleVersion  "8.9.0.0"
+    Import-DSCResource -modulename "xPSDesiredStateConfiguration" -ModuleVersion  "8.10.0.0"
     Import-DSCResource -modulename "xActiveDirectory" -ModuleVersion  "3.0.0.0"
     Import-DSCResource -modulename "xComputerManagement" -ModuleVersion  "4.1.0.0"
     Import-DSCResource -modulename "xNetworking" -ModuleVersion  "5.7.0.0"
diff --git a/Configurations/PowerShellLab/VMConfigurationData.psd1 b/Configurations/PowerShellLab/VMConfigurationData.psd1
@@ -203,7 +203,7 @@ demonstrations and would need to be modified for your environment.
                 @{ Name = 'xNetworking'; RequiredVersion = '5.7.0.0'; Provider = 'PSGallery'; },
                 @{ Name = 'xDhcpServer'; RequiredVersion = '2.0.0.0'; Provider = 'PSGallery';  },
                 @{ Name = 'xWindowsUpdate' ; RequiredVersion = '2.8.0.0'; Provider = 'PSGallery';},
-                @{ Name = 'xPSDesiredStateConfiguration'; RequiredVersion = '8.9.0.0'; },
+                @{ Name = 'xPSDesiredStateConfiguration'; RequiredVersion = '8.10.0.0'; },
                 @{ Name = 'xPendingReboot'; RequiredVersion = '0.4.0.0'; Provider = 'PSGallery';},
                 @{ Name = 'xADCSDeployment'; RequiredVersion = '1.4.0.0'; Provider = 'PSGallery';},
                 @{ Name = 'xDnsServer';RequiredVersion = "1.15.0.0";Provider = 'PSGallery';},
diff --git a/Configurations/SingleServer/VMConfiguration.ps1 b/Configurations/SingleServer/VMConfiguration.ps1
@@ -7,7 +7,7 @@ Configuration AutoLab {
 
     #region DSC Resources
     Import-DSCresource -ModuleName "PSDesiredStateConfiguration" -ModuleVersion "1.1"
-    Import-DSCResource -modulename "xPSDesiredStateConfiguration" -ModuleVersion  "8.9.0.0"
+    Import-DSCResource -modulename "xPSDesiredStateConfiguration" -ModuleVersion  "8.10.0.0"
     Import-DSCResource -modulename "xComputerManagement" -ModuleVersion  "4.1.0.0"
     Import-DSCResource -modulename "xNetworking" -ModuleVersion  "5.7.0.0"
 
diff --git a/Configurations/SingleServer/VMConfigurationData.psd1 b/Configurations/SingleServer/VMConfigurationData.psd1
@@ -120,7 +120,7 @@ demonstrations and would need to be modified for your environment.
             );
             DSCResource = @(
                 ## Download published version from the PowerShell Gallery or Github
-                @{ Name = 'xPSDesiredStateConfiguration'; RequiredVersion = '8.9.0.0'; },
+                @{ Name = 'xPSDesiredStateConfiguration'; RequiredVersion = '8.10.0.0'; Provider = 'PSGallery'; },
                 @{ Name = 'xComputerManagement'; RequiredVersion = '4.1.0.0'; Provider = 'PSGallery'; },
                 @{ Name = 'xNetworking'; RequiredVersion = '5.7.0.0'; Provider = 'PSGallery'; }
 
diff --git a/Configurations/Windows10/Instructions.md b/Configurations/Windows10/Instructions.md
@@ -2,7 +2,7 @@
 
 This lab builds the following:
 
-* 1 Workgroup joined Windows 10 Client with RSAT tools installed.
+* 1 Workgroup joined Windows 10 Client (Win10Ent) with RSAT tools installed.
 
 It will also create a local user account with a password of `P@ssw0rd` using same name as the person running the configuration. In other words, it will use the value of `$env:username`.
 
diff --git a/Configurations/Windows10/VMConfiguration.ps1 b/Configurations/Windows10/VMConfiguration.ps1
@@ -24,15 +24,12 @@ Configuration AutoLab {
     $credential = New-Object -typename Pscredential -ArgumentList Administrator, $secure
 
     Import-DscResource -ModuleName "PSDesiredStateConfiguration" -ModuleVersion "1.1"
-
-    #import dscresources from the configuration data
-    Import-DscResource -ModuleName "xPSDesiredStateConfiguration" -ModuleVersion "8.9.0.0"
+    Import-DscResource -ModuleName "xPSDesiredStateConfiguration" -ModuleVersion "8.10.0.0"
     Import-DscResource -ModuleName "xComputerManagement" -ModuleVersion "4.1.0.0"
     Import-DscResource -ModuleName "xNetworking" -ModuleVersion "5.7.0.0"
     Import-DscResource -ModuleName "xWindowsUpdate" -ModuleVersion "2.8.0.0"
     Import-DscResource -ModuleName "xPendingReboot" -ModuleVersion "0.4.0.0"
 
-
     Node $AllNodes.Where( { $true }).NodeName {
         xComputer ComputerName {
             Name          = $Node.NodeName
diff --git a/Configurations/Windows10/VMConfigurationData.psd1 b/Configurations/Windows10/VMConfigurationData.psd1
@@ -114,7 +114,7 @@ demonstrations and would need to be modified for your environment.
                 @{ Name = 'xComputerManagement'; RequiredVersion = '4.1.0.0'; Provider = 'PSGallery'; },
                 @{ Name = 'xNetworking'; RequiredVersion = '5.7.0.0'; Provider = 'PSGallery'; },
                 @{ Name = 'xWindowsUpdate' ; RequiredVersion = '2.8.0.0'; Provider = 'PSGallery'; },
-                @{ Name = 'xPSDesiredStateConfiguration'; RequiredVersion = '8.9.0.0'; Provider = 'PSGallery'},
+                @{ Name = 'xPSDesiredStateConfiguration'; RequiredVersion = '8.10.0.0'; Provider = 'PSGallery'},
                 @{ Name = 'xPendingReboot'; RequiredVersion = '0.4.0.0'; Provider = 'PSGallery'}
             );
             Resource    = @(
diff --git a/Configurations/microsoft-powershell-implementing-jea/Instructions.md b/Configurations/microsoft-powershell-implementing-jea/Instructions.md
@@ -2,10 +2,10 @@
 
 This lab builds the following:
 
-* 1 DC (DC1)
-* 1 Server (S1)
-* 1 Nano (N1)
-* 1 Client with RSAT (Cli1)
+* 1 DC (DC1 - Windows Server 2016 Core)
+* 1 Server (S1 - Windows Server 2016 Core)
+* 1 Nano (N1 - Windows Server 2016 Nano)
+* 1 Client with RSAT (Cli1 - Windows 10 Enterprise)
 
 ## To get started
 
@@ -17,7 +17,7 @@ This lab builds the following:
     Run the following for initial setup:
     PS> Setup-Lab
 
-    To start the LAb, and apply configurations the first time:
+    To start the Lsb, and apply configurations the first time:
     PS> Run-Lab
 
     To enable Internet access for the VM's, run:
diff --git a/Configurations/microsoft-powershell-implementing-jea/VMConfiguration.ps1 b/Configurations/microsoft-powershell-implementing-jea/VMConfiguration.ps1
@@ -24,7 +24,7 @@ Configuration AutoLab {
 
     #region DSC Resources
     Import-DSCresource -ModuleName "PSDesiredStateConfiguration" -ModuleVersion "1.1"
-    Import-DSCResource -modulename "xPSDesiredStateConfiguration" -ModuleVersion  "8.9.0.0"
+    Import-DSCResource -modulename "xPSDesiredStateConfiguration" -ModuleVersion  "8.10.0.0"
     Import-DSCResource -modulename "xActiveDirectory" -ModuleVersion  "3.0.0.0"
     Import-DSCResource -modulename "xComputerManagement" -ModuleVersion  "4.1.0.0"
     Import-DSCResource -modulename "xNetworking" -ModuleVersion  "5.7.0.0"
diff --git a/Configurations/microsoft-powershell-implementing-jea/VMConfigurationData.psd1 b/Configurations/microsoft-powershell-implementing-jea/VMConfigurationData.psd1
@@ -196,10 +196,9 @@ demonstrations and would need to be modified for your environment.
                 @{ Name = 'xNetworking'; RequiredVersion = '5.7.0.0'; Provider = 'PSGallery'; },
                 @{ Name = 'xDhcpServer'; RequiredVersion = '2.0.0.0'; Provider = 'PSGallery';  },
                 @{ Name = 'xWindowsUpdate' ; RequiredVersion = '2.8.0.0'; Provider = 'PSGallery';},
-                @{ Name = 'xPSDesiredStateConfiguration'; RequiredVersion = '8.9.0.0'; },
+                @{ Name = 'xPSDesiredStateConfiguration'; RequiredVersion = '8.10.0.0'; Provider = 'PSGallery'; },
                 @{ Name = 'xPendingReboot'; RequiredVersion = '0.4.0.0'; Provider = 'PSGallery';},
                 @{ Name = 'xADCSDeployment'; RequiredVersion = '1.4.0.0'; Provider = 'PSGallery';}
-
             );
             Resource = @(
                 @{
diff --git a/PSAutoLab.psd1 b/PSAutoLab.psd1
diff --git a/README.md b/README.md
@@ -32,7 +32,7 @@ You must have administrator access and be able to update TrustedHosts.
 If you are in a corporate environment, these settings may be locked down or restricted.
 If this applies to you, this module may not work for you.
 
-*This module and configurations have NOT been tested running from PowerShell Core or PowerShell 7 and is not supported at this time.*
+**This module and configurations have NOT been tested running from PowerShell Core or PowerShell 7 and is not supported at this time.**
 
 ## Aliases and Language
 
@@ -205,7 +205,34 @@ PS C:\Autolab\Configurations\SingleServer\> Wipe-Lab
 This will remove the virtual machines and DSC configuration files.
 If you intend to rebuild the lab or another configuration, you can keep the LabNat virtual switch.
 
-## Updating
+## Windows Updates
+
+When you build an lab, you are creating Windows virtual machines based on evaluation software.
+You might still want to make sure the virtual machines are up to date with security patches and updates.
+You can use `Update-Lab``to invoke Windows update on all lab members.
+This can be a time consuming process, so you have an option to run the updates as a background job.
+Just be sure not to close your PowerShell session before the jobs complete.
+
+```powershell
+PS C:\Autolab\Configurations\PowerShellLab> update-lab -AsJob
+
+Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
+--     ----            -------------   -----         -----------     --------             -------
+18     WUUpdate        RemoteJob       Running       True            DOM1                  WUUpdate
+21     WUUpdate        RemoteJob       Running       True            SRV1                  WUUpdate
+24     WUUpdate        RemoteJob       Running       True            SRV2                  WUUpdate
+27     WUUpdate        RemoteJob       Running       True            SRV3                  WUUpdate
+30     WUUpdate        RemoteJob       Running       True            WIN10                 WUUpdate
+
+PS C:\Autolab\Configurations\PowerShellLab> receive-job -id 27 -Keep
+[11/22/2019 12:05:43] Found 5 updates to install on SRV3
+[11/22/2019 12:25:13] Update process complete on SRV3
+WARNING: SRV3 requires a reboot
+```
+
+Run the update process as a background job. Use the PowerShell job cmdlets to manage.
+
+## Updating PSAutolab
 
 As this module is updated over time, new configurations may be added, or bugs fixed in existing configurations.
 There may also be new Lability updates.
@@ -281,7 +308,7 @@ It is recommended that you restart your PowerShell session and try the lab setup
 ## Acknowledgments
 
 This module is a continuation of the work done by Jason Helmick and Melissa (Missy) Januszko, whose efforts are greatly appreciated.
-Beginning with v4.0.0, this module is unrelated to any projects Jason may be developing under similar names.
+Beginning with v4.0.0, this module is unrelated to any projects Jason or Missy may be developing under similar names.
 
 ## Road Map
 
@@ -294,4 +321,4 @@ These are some of the items that are being considered for future updates:
 
 A complete list of enhancements can be found in [Issues](https://github.com/pluralsight/PS-AutoLab-Env/issues).
 
-Last Updated 2019-09-30 16:50:51Z UTC
+Last Updated 2019-11-22 17:11:37Z UTC
diff --git a/Usage-FAQ.md b/Usage-FAQ.md
@@ -1,7 +1,8 @@
-# FAQ
+# Usage FAQ
 
 These are some common questions you might have about this module or errors that you might encounter.
-There is also an ongoing FAQ under Issues of common problems and resolutions.
+If you haven't already done so, you should read the [README](./README.md) file.
+And don't forget the [About_PSAutolab](./docs/about_PSAutoLab.md) file.
 
 ## I get an error about trying to modify TrustedHosts
 
@@ -74,15 +75,13 @@ The solution is to coordinate a single NAT network so it covers all of your NAT
 
 - That likely means creating a larger NAT subnet that covers the IP ranges of all of your networks.
 - Which also means coordinating IP ranges across apps so they can fall under a single NAT subnet.
-- Also, the NAT subnet cannot overlap with the external network that the host is attached to. So if a host is attached to 192.168.0.0/24, you can't use 192.168.0.0/16 as a NAT network.
+- The NAT subnet cannot overlap with the external network that the host is attached to. If a host is attached to 192.168.0.0/24, you can't use 192.168.0.0/16 as a NAT network.
 
 Here's a visualization from the above limitations article:
 ![overlapping prefixes](https://msdnshared.blob.core.windows.net/media/2016/05/Overlapping-Internal-Prefixes.jpg)
 
 Refer to this article for help on creating NAT networks: https://msdn.microsoft.com/en-us/virtualization/hyperv_on_windows/user_guide/setup_nat_network
 
-Here are some helpful PowerShell commands
-
 #### List NAT networks, take note of the IP range and subnet
 
 ```powershell
@@ -122,13 +121,14 @@ First, find your desired timezone using one of these techniques:
 
 ```powershell
 # Filter all timezones, take the Id property from the desired timezone:
+[System.TimeZoneInfo]::GetSystemTimeZones()
 [System.TimeZoneInfo]::GetSystemTimeZones().Where({$_.Id -like '*Eastern*'})
 
 # Get your current timezone:
 (Get-TimeZone).Id
 ```
 
-Next, pen the lab's `VMConfigurarationData.psd1` in your script editor and change `Lability_timeZone` per Node.
+Next, open the lab's `VMConfigurarationData.psd1` in your script editor and change `Lability_timeZone` per Node.
 
 ```powershell
  @{
diff --git a/changelog.txt b/changelog.txt
@@ -1,11 +1,17 @@
 Changelog for PSAutoLab
 
-v4.3.1
+v4.4.0
 
 Modified Pester tests with a little more error handling.
-Updated xDNSServer required resource to 1.15.0.0
 Moved default user location to the Employees OU instead of the domain root for the PowerShellLab configuration
+Added Test-isAdministrator private function
 Updated Get-PSAutolabSetting to reflect memory in GB, report on percent free memory, and Hyper-V version
+Updated Get-PSAutolabSetting to show all installed versions of Lability and PSAutolab modules
+Updated Get-PSAutolabSetting to show if running with elevated privileges
+Updated xPSDesiredStateConfiguration resource to 8.10.0.0
+Updated xDNSServer to 1.15.0.0
+Added Invoke-WUUpdate as a private function with a public wrapper function of Update-Lab to install Windows Updates on the virtual machines.
+Help and documentation updates
 
 v4.3.0
 
@@ -15,7 +21,7 @@ Updated configuration scripts to better import DSC resource modules
 Modified Wipe-Lab to allow removing lab elements without prompting and removing Lab switch is now optional. (Issue #191)
 Modified Unattend-Lab to run in a background job (Issue #190)
 Updated Get-PSAutolabSetting to get Pester version (Issue #197)
-Updated Get-Labsnapshot (Issue #192)
+Updated Get-LabSnapshot (Issue #192)
 Help updates
 
 v4.2.0
diff --git a/docs/Get-PSAutoLabSetting.md b/docs/Get-PSAutoLabSetting.md
@@ -29,14 +29,21 @@ Include the output in your GitHub issue.
 ```powershell
 PS C:\> Get-PSAutoLabSetting
 
-PSVersion : 5.1.18362.145
-Edition   : Desktop
-OS        : Microsoft Windows 10 Pro
-PSAutolab : 4.1.0
-Lability  : 0.18.0
-Memory    : 33442716
+PSVersion     : 5.1.18362.145
+PSEdition     : Desktop
+OS            : Microsoft Windows 10 Pro
+IsElevated    : True
+HyperV        : 10.0.18362.1
+PSAutolab     : {4.3.0, 4.1.1, 4.1.0, 4.0.0}
+Lability      : {0.18.0, 0.12.4, 0.10.1}
+Pester        : 4.9.0
+MemoryGB      : 32
+PctFreeMemory : 15.24
 ```
 
+The output will also show previously installed versions of the PSAutolab and Lability modules.
+Only the latest version should be loaded. You can remove the older versions if you no longer need them by running Uninstall-Module -name <modulename> -requiredversion <version number>.
+
 Copy and paste this information into a GitHub issue along with any relevant error messages.
 
 ## PARAMETERS
diff --git a/docs/Update-Lab.md b/docs/Update-Lab.md
diff --git a/docs/about_PSAutoLab.md b/docs/about_PSAutoLab.md
diff --git a/en-us/PSAutoLab-help.xml b/en-us/PSAutoLab-help.xml
diff --git a/en-us/about_PSAutoLab.help.txt b/en-us/about_PSAutoLab.help.txt
diff --git a/functions/private.ps1 b/functions/private.ps1
diff --git a/functions/public.ps1 b/functions/public.ps1
