GetComputerInfoCommand.cs

/********************************************************************++
Copyright (c) Microsoft Corporation.  All rights reserved.
--********************************************************************/

using System;
using System.Collections.Generic;
using System.Runtime.InteropServices;
using System.Reflection;
using System.Linq.Expressions;
using System.Management.Automation;
using System.Diagnostics.CodeAnalysis;

using Microsoft.Management.Infrastructure;
using Microsoft.Win32;

namespace Microsoft.PowerShell.Commands
{
    using Extensions;

    #region GetComputerInfoCommand cmdlet implementation
    /// <summary>
    /// The Get=ComputerInfo cmdlet gathers and reports information
    /// about a computer.
    /// </summary>
    [Cmdlet(VerbsCommon.Get, "ComputerInfo",
        HelpUri = "https://go.microsoft.com/fwlink/?LinkId=799466")]
    [Alias("gin")]
    [OutputType(typeof(ComputerInfo), typeof(PSObject))]
    public class GetComputerInfoCommand : PSCmdlet
    {
        #region Inner Types
        private class OSInfoGroup
        {
            public WmiOperatingSystem os;
            public HotFix[] hotFixes;
            public WmiPageFileUsage[] pageFileUsage;
            public string halVersion;
            public TimeSpan? upTime;
            public RegWinNtCurrentVersion regCurVer;
        }

        private class SystemInfoGroup
        {
            public WmiBaseBoard baseboard;
            public WmiBios bios;
            public WmiComputerSystem computer;
            public Processor[] processors;
            public NetworkAdapter[] networkAdapters;
        }

        private class HyperVInfo
        {
            public bool? Present;
            public bool? VMMonitorModeExtensions;
            public bool? SecondLevelAddressTranslation;
            public bool? VirtualizationFirmwareEnabled;
            public bool? DataExecutionPreventionAvailable;
        }

        private class DeviceGuardInfo
        {
            public DeviceGuardSmartStatus status;
            public DeviceGuard deviceGuard;
        }

        private class MiscInfoGroup
        {
            public UInt64? physicallyInstalledMemory;
            public string timeZone;
            public string logonServer;
            public FirmwareType? firmwareType;
            public PowerPlatformRole? powerPlatformRole;
            public WmiKeyboard[] keyboards;
            public HyperVInfo hyperV;
            public ServerLevel? serverLevel;
            public DeviceGuardInfo deviceGuard;
        }
        #endregion Inner Types

        #region Static Data and Constants
        private const string activity = "Get-ComputerInfo";
        private const string localMachineName = null;
        #endregion Static Data and Constants

        #region Instance Data
        private string _machineName = localMachineName;  // we might need to have cmdlet work on another machine
        private ProgressRecord _progress = null;

        /// <summary>
        /// Collection of property names from the Property parameter,
        /// including any names resulting from the expansion of wild-card
        /// patterns given. This list will itself contain no wildcard patterns.
        /// </summary>
        private List<string> _namedProperties = null;
        #endregion Instance Data

        #region Parameters
        /// <summary>
        /// The Property parameter contains the names of properties to be retrieved.
        /// If this parameter is given, the cmdlet returns a PSCustomObject
        /// containing only the requested properties.
        /// Wild-card patterns may be provided
        /// </summary>
        /// <remarks>
        /// <para>
        /// Any named properties that are not recognized are ignored. If no
        /// recognized properties are provided the cmdlet returns an empty
        /// PSCustomObject.
        /// </para>
        /// <para>
        /// If a provided wild-card pattern contains only an asterisk ("*"),
        /// the cmdlet will operate as if the parameter were not given at all
        /// and will return a fully-populated ComputerInfo object.
        /// </para>
        /// </remarks>
        [Parameter(Position = 0,
                   ValueFromPipeline = true,
                   ValueFromPipelineByPropertyName = true)]
        [SuppressMessage("Microsoft.Performance", "CA1819:PropertiesShouldNotReturnArrays")]
        public string[] Property { get; set; }
        #endregion Parameters

        #region Cmdlet Overrides
        /// <summary>
        /// Perform any first-stage processing
        /// </summary>
        protected override void BeginProcessing()
        {
            // if the Property parameter was given, determine the requested
            // property names
            if (Property != null && Property.Length > 0)
            {
                try
                {
                    _namedProperties = CollectPropertyNames(Property);
                }
                catch (WildcardPatternException ex)
                {
                    WriteError(new ErrorRecord(ex, "WildcardPattern", ErrorCategory.InvalidArgument, this));
                }
            }
        }

        /// <summary>
        /// Performs the cmdlet's work
        /// </summary>
        protected override void ProcessRecord()
        {
            // if the user provided property names but no matching properties
            // were found, return an empty custom object
            if (_namedProperties != null && _namedProperties.Count == 0)
            {
                WriteObject(new PSObject());
                return;
            }

            MiscInfoGroup miscInfo = null;
            var osInfo = new OSInfoGroup();
            var systemInfo = new SystemInfoGroup();
            var now = DateTime.Now;

            using (var session = CimSession.Create(_machineName))
            {
                UpdateProgress(ComputerInfoResources.LoadingOperationSystemInfo);

                osInfo.os = session.GetFirst<WmiOperatingSystem>(CIMHelper.ClassNames.OperatingSystem);
                osInfo.pageFileUsage = session.GetAll<WmiPageFileUsage>(CIMHelper.ClassNames.PageFileUsage);

                if (osInfo.os != null)
                {
                    osInfo.halVersion = GetHalVersion(session, osInfo.os.SystemDirectory);

                    if (osInfo.os.LastBootUpTime != null)
                        osInfo.upTime = now - osInfo.os.LastBootUpTime.Value;
                }

                UpdateProgress(ComputerInfoResources.LoadingHotPatchInfo);
                osInfo.hotFixes = session.GetAll<HotFix>(CIMHelper.ClassNames.HotFix);

                UpdateProgress(ComputerInfoResources.LoadingRegistryInfo);
                osInfo.regCurVer = RegistryInfo.GetWinNtCurrentVersion();

                UpdateProgress(ComputerInfoResources.LoadingBiosInfo);
                systemInfo.bios = session.GetFirst<WmiBios>(CIMHelper.ClassNames.Bios);

                UpdateProgress(ComputerInfoResources.LoadingMotherboardInfo);
                systemInfo.baseboard = session.GetFirst<WmiBaseBoard>(CIMHelper.ClassNames.BaseBoard);

                UpdateProgress(ComputerInfoResources.LoadingComputerInfo);
                systemInfo.computer = session.GetFirst<WmiComputerSystem>(CIMHelper.ClassNames.ComputerSystem);
                miscInfo = GetOtherInfo(session);

                UpdateProgress(ComputerInfoResources.LoadingProcessorInfo);
                systemInfo.processors = GetProcessors(session);

                UpdateProgress(ComputerInfoResources.LoadingNetworkAdapterInfo);
                systemInfo.networkAdapters = GetNetworkAdapters(session);

                UpdateProgress(null);   // close the progress bar
            } // end of using(CimSession...)

            var infoOutput = CreateFullOutputObject(systemInfo, osInfo, miscInfo);

            if (_namedProperties != null)
            {
                //var output = CreateCustomOutputObject(namedProperties, systemInfo, osInfo, miscInfo);
                var output = CreateCustomOutputObject(infoOutput, _namedProperties);

                WriteObject(output);
            }
            else
            {
                WriteObject(infoOutput);
            }
        }
        #endregion Cmdlet Overrides

        #region Private Methods
        /// <summary>
        /// Display progress
        /// </summary>
        /// <param name="status">
        /// Text to be displayed in status bar
        /// </param>
        private void UpdateProgress(string status)
        {
            if (_progress != null)
            {
                _progress.RecordType = ProgressRecordType.Completed;
                WriteProgress(_progress);
            }

            if (status != null)
            {
                _progress = new ProgressRecord(0, activity, status);
                WriteProgress(_progress);
            }
        }

        /// <summary>
        /// Retrieves the version of the system's hal.dll.
        /// </summary>
        /// <param name="session">
        /// A <see cref="Microsoft.Management.Infrastructure.CimSession"/> object
        /// representing the CIM session to query.
        /// </param>
        /// <param name="systemDirectory">
        /// Path to the system directory, which should contain the hal.dll file.
        /// </param>
        private static string GetHalVersion(CimSession session, string systemDirectory)
        {
            string halVersion = null;

            try
            {
                var halPath = CIMHelper.EscapePath(System.IO.Path.Combine(systemDirectory, "hal.dll"));
                var query = string.Format("SELECT * FROM CIM_DataFile Where Name='{0}'", halPath);
                var instance = session.QueryFirstInstance(query);

                if (instance != null)
                    halVersion = instance.CimInstanceProperties["Version"].Value.ToString();
            }
            catch (Exception)
            {
                // On any error, fall through to the return
            }

            return halVersion;
        }

        /// <summary>
        /// Create an array of <see cref="NetworkAdapter"/> object from values in
        /// Win32_NetworkAdapter and Win32_NetworkAdapterConfiguration instances.
        /// </summary>
        /// <param name="session">
        /// A <see cref="Microsoft.Management.Infrastructure.CimSession"/> object representing
        /// a CIM session.
        /// </param>
        /// <returns>
        /// An array of NetworkAdapter objects.
        /// </returns>
        /// <remarks>
        /// This method matches network adapters associated network adapter configurations.
        /// The returned array contains entries only for matched adapter/configuration objects.
        /// </remarks>
        private static NetworkAdapter[] GetNetworkAdapters(CimSession session)
        {
            var adaptersMsft = session.GetAll<WmiMsftNetAdapter>(CIMHelper.MicrosoftNetworkAdapterNamespace, CIMHelper.ClassNames.MicrosoftNetworkAdapter);
            var adapters = session.GetAll<WmiNetworkAdapter>(CIMHelper.ClassNames.NetworkAdapter);
            var configs = session.GetAll<WmiNetworkAdapterConfiguration>(CIMHelper.ClassNames.NetworkAdapterConfiguration);

            var list = new List<NetworkAdapter>();

            if (adapters != null && configs != null)
            {
                var configDict = new Dictionary<UInt32, WmiNetworkAdapterConfiguration>();

                foreach (var config in configs)
                {
                    if (config.Index != null)
                        configDict[config.Index.Value] = config;
                }

                if (configDict.Count > 0)
                {
                    foreach (var adapter in adapters)
                    {
                        // Only include adapters that have a non-null connection status
                        // and a non-null index
                        if (adapter.NetConnectionStatus != null
                            && adapter.Index != null)
                        {
                            if (configDict.ContainsKey(adapter.Index.Value))
                            {
                                var config = configDict[adapter.Index.Value];
                                var nwAdapter = new NetworkAdapter
                                {
                                    Description = adapter.Description,
                                    ConnectionID = adapter.NetConnectionID
                                };

                                var status = EnumConverter<NetConnectionStatus>.Convert(adapter.NetConnectionStatus);
                                nwAdapter.ConnectionStatus = status == null ? NetConnectionStatus.Other
                                                                            : status.Value;

                                if (nwAdapter.ConnectionStatus == NetConnectionStatus.Connected)
                                {
                                    nwAdapter.DHCPEnabled = config.DHCPEnabled;
                                    nwAdapter.DHCPServer = config.DHCPServer;
                                    nwAdapter.IPAddresses = config.IPAddress;
                                }

                                list.Add(nwAdapter);
                            }
                        }
                    }
                }
            }

            return list.ToArray();
        }

        /// <summary>
        /// Create an array of <see cref="Processor"/> objects, using data acquired
        /// from WMI via the Win32_Processor class.
        /// </summary>
        /// <param name="session"></param>
        /// <returns></returns>
        private static Processor[] GetProcessors(CimSession session)
        {
            var processors = session.GetAll<WmiProcessor>(CIMHelper.ClassNames.Processor);

            if (processors != null)
            {
                var list = new List<Processor>();

                foreach (var processor in processors)
                {
                    var proc = new Processor();

                    proc.AddressWidth = processor.AddressWidth;
                    proc.Architecture = EnumConverter<CpuArchitecture>.Convert(processor.Architecture);
                    proc.Availability = EnumConverter<CpuAvailability>.Convert(processor.Availability);
                    proc.CpuStatus = EnumConverter<CpuStatus>.Convert(processor.CpuStatus);
                    proc.CurrentClockSpeed = processor.CurrentClockSpeed;
                    proc.DataWidth = processor.DataWidth;
                    proc.Description = processor.Description;
                    proc.Manufacturer = processor.Manufacturer;
                    proc.MaxClockSpeed = processor.MaxClockSpeed;
                    proc.Name = processor.Name;
                    proc.NumberOfCores = processor.NumberOfCores;
                    proc.NumberOfLogicalProcessors = processor.NumberOfLogicalProcessors;
                    proc.ProcessorID = processor.ProcessorId;
                    proc.ProcessorType = EnumConverter<ProcessorType>.Convert(processor.ProcessorType);
                    proc.Role = processor.Role;
                    proc.SocketDesignation = processor.SocketDesignation;
                    proc.Status = processor.Status;

                    list.Add(proc);
                }

                return list.ToArray();
            }

            return null;
        }

        private static bool CheckDeviceGuardLicense()
        {
            const string propertyName = "CodeIntegrity-AllowConfigurablePolicy";

            // DeviceGuard is supported on all versions of PowerShell that execute on "full" SKUs
            if (Platform.IsWindows &&
                !(Platform.IsNanoServer || Platform.IsIoT))
            {
                try
                {
                    int policy = 0;

                    if (Native.SLGetWindowsInformationDWORD(propertyName, out policy) == Native.S_OK
                        && policy == 1)
                    {
                        return true;
                    }
                }
                catch (Exception)
                {
                    // if we fail to load the native dll or if the call fails
                    // catastrophically there's not much we can do except to
                    // consider there to be no license.
                }
            }
            return false;
        }

        /// <summary>
        /// Retrieve information related to Device Guard
        /// </summary>
        /// <param name="session">
        /// A <see cref="Microsoft.Management.Infrastructure.CimSession"/> object representing
        /// a CIM session.
        /// </param>
        /// <returns>
        /// A <see cref="DeviceGuard"/> object containing information related to
        /// the Device Guard feature
        /// </returns>
        private static DeviceGuardInfo GetDeviceGuard(CimSession session)
        {
            DeviceGuard guard = null;
            var status = DeviceGuardSmartStatus.Off;

            if (CheckDeviceGuardLicense())
            {
                var wmiGuard = session.GetFirst<WmiDeviceGuard>(CIMHelper.DeviceGuardNamespace,
                                                                CIMHelper.ClassNames.DeviceGuard);

                if (wmiGuard != null)
                    guard = wmiGuard.AsOutputType;
            }

            return new DeviceGuardInfo
            {
                status = status,
                deviceGuard = guard
            };
        }

        /// <summary>
        /// A helper method used by GetHyperVisorInfo to retrieve a boolean
        /// property value.
        /// </summary>
        private static bool? GetBooleanProperty(CimInstance instance, string propertyName)
        {
            if (instance != null)
            {
                try
                {
                    var property = instance.CimInstanceProperties[propertyName];

                    if (property != null && property.Value != null)
                        return (bool)property.Value;
                }
                catch (Exception)
                {
                    // just in case the cast fails
                    // fall through to the null return
                }
            }

            return null;
        }

        /// <summary>
        /// Retrieve information related to HyperVisor
        /// </summary>
        /// <param name="session">
        /// A <see cref="Microsoft.Management.Infrastructure.CimSession"/> object representing
        /// a CIM session.
        /// </param>
        /// <returns>
        /// A <see cref="HyperVInfo"/> object containing information related to
        /// HyperVisor
        /// </returns>
        private static HyperVInfo GetHyperVisorInfo(CimSession session)
        {
            HyperVInfo info = new HyperVInfo();
            bool ok = false;
            CimInstance instance = null;

            using (instance = session.QueryFirstInstance(CIMHelper.WqlQueryAll(CIMHelper.ClassNames.ComputerSystem)))
            {
                if (instance != null)
                {
                    info.Present = GetBooleanProperty(instance, "HypervisorPresent");
                    ok = true;
                }
            }

            // don't bother checking requirements if the HyperV in present
            // when the HyperV is present, the requirements values are misleading
            if (ok && info.Present != null && info.Present.Value)
                return info;

            using (instance = session.QueryFirstInstance(CIMHelper.WqlQueryAll(CIMHelper.ClassNames.OperatingSystem)))
            {
                if (instance != null)
                {
                    info.DataExecutionPreventionAvailable = GetBooleanProperty(instance, "DataExecutionPrevention_Available");
                    ok = true;
                }
            }

            using (instance = session.QueryFirstInstance(CIMHelper.WqlQueryAll(CIMHelper.ClassNames.Processor)))
            {
                if (instance != null)
                {
                    info.SecondLevelAddressTranslation = GetBooleanProperty(instance, "SecondLevelAddressTranslationExtensions");
                    info.VirtualizationFirmwareEnabled = GetBooleanProperty(instance, "VirtualizationFirmwareEnabled");
                    info.VMMonitorModeExtensions = GetBooleanProperty(instance, "VMMonitorModeExtensions");
                    ok = true;
                }
            }

            return ok ? info : null;
        }

        /// <summary>
        /// Retrieve miscellaneous system information
        /// </summary>
        /// <param name="session">
        /// A <see cref="Microsoft.Management.Infrastructure.CimSession"/> object representing
        /// a CIM session.
        /// </param>
        /// <returns>
        /// A <see cref="MiscInfoGroup"/> object containing miscellaneous
        /// system information
        /// </returns>
        private static MiscInfoGroup GetOtherInfo(CimSession session)
        {
            var rv = new MiscInfoGroup();

            // get platform role
            try
            {
                //TODO: Local machine only. Check for that?
                uint powerRole = Native.PowerDeterminePlatformRoleEx(Native.POWER_PLATFORM_ROLE_V2);
                if (powerRole >= (uint)PowerPlatformRole.MaximumEnumValue)
                    rv.powerPlatformRole = PowerPlatformRole.Unspecified;
                else
                    rv.powerPlatformRole = EnumConverter<PowerPlatformRole>.Convert((int)powerRole);
            }
            catch (Exception)
            {
                // probably failed to load the DLL with PowerDeterminePlatformRoleEx
                // either way, move on
            }

            // get secure-boot info
            //TODO: Local machine only? Check for that?
            rv.firmwareType = GetFirmwareType();

            // get amount of memory physically installed
            //TODO: Local machine only. Check for that?
            rv.physicallyInstalledMemory = GetPhysicallyInstalledSystemMemory();


            // get time zone
            // we'll use .Net's TimeZoneInfo for now. systeminfo uses Caption from Win32_TimeZone
            var tzi = TimeZoneInfo.Local;
            if (tzi != null)
                rv.timeZone = tzi.DisplayName;

            rv.logonServer = RegistryInfo.GetLogonServer();

            rv.keyboards = session.GetAll<WmiKeyboard>(CIMHelper.ClassNames.Keyboard);

            rv.hyperV = GetHyperVisorInfo(session);

            var serverLevels = RegistryInfo.GetServerLevels();
            uint value;

            if (serverLevels.TryGetValue("NanoServer", out value) && value == 1)
            {
                rv.serverLevel = ServerLevel.NanoServer;
            }
            else if (serverLevels.TryGetValue("ServerCore", out value) && value == 1)
            {
                rv.serverLevel = ServerLevel.ServerCore;

                if (serverLevels.TryGetValue("Server-Gui-Mgmt", out value) && value == 1)
                {
                    rv.serverLevel = ServerLevel.ServerCoreWithManagementTools;

                    if (serverLevels.TryGetValue("Server-Gui-Shell", out value) && value == 1)
                        rv.serverLevel = ServerLevel.FullServer;
                }
            }

            rv.deviceGuard = GetDeviceGuard(session);

            return rv;
        }

        /// <summary>
        /// Wrapper around the native GetFirmwareType function.
        /// </summary>
        /// <returns>
        /// null if unsuccessful, otherwise FirmwareType enum specifying
        /// the firmware type.
        /// </returns>
        private static Nullable<FirmwareType> GetFirmwareType()
        {
            try
            {
                FirmwareType firmwareType;

                if (Native.GetFirmwareType(out firmwareType))
                    return firmwareType;
            }
            catch (Exception)
            {
                // Probably failed to load the DLL or to file the function entry point.
                // Fail silently
            }

            return null;
        }

        /// <summary>
        /// Wrapper around the native GetPhysicallyInstalledSystemMemory function.
        /// </summary>
        /// <returns>
        /// null if unsuccessful, otherwise the amount of physically installed memory.
        /// </returns>
        private static Nullable<UInt64> GetPhysicallyInstalledSystemMemory()
        {
            try
            {
                UInt64 memory;
                if (Native.GetPhysicallyInstalledSystemMemory(out memory))
                    return memory;
            }
            catch (Exception)
            {
                // Probably failed to load the DLL or to file the function entry point.
                // Fail silently
            }

            return null;
        }

        /// <summary>
        /// Create a new ComputerInfo object populated with the specified data objects.
        /// </summary>
        /// <param name="systemInfo">
        /// A <see cref="SystemInfoGroup"/> object containing system-related info
        /// such as BIOS, mother-board, computer system, etc.
        /// </param>
        /// <param name="osInfo">
        /// An <see cref="OSInfoGroup"/> object containing operating-system information.
        /// </param>
        /// <param name="otherInfo">
        /// A <see cref="MiscInfoGroup"/> object containing other information to be reported.
        /// </param>
        /// <returns>
        /// A new ComputerInfo object to be output to PowerShell.
        /// </returns>
        private static ComputerInfo CreateFullOutputObject(SystemInfoGroup systemInfo, OSInfoGroup osInfo, MiscInfoGroup otherInfo)
        {
            var output = new ComputerInfo();

            var regCurVer = osInfo.regCurVer;
            if (regCurVer != null)
            {
                output.WindowsBuildLabEx = regCurVer.BuildLabEx;
                output.WindowsCurrentVersion = regCurVer.CurrentVersion;
                output.WindowsEditionId = regCurVer.EditionId;
                output.WindowsInstallationType = regCurVer.InstallationType;
                output.WindowsInstallDateFromRegistry = regCurVer.InstallDate;
                output.WindowsProductId = regCurVer.ProductId;
                output.WindowsProductName = regCurVer.ProductName;
                output.WindowsRegisteredOrganization = regCurVer.RegisteredOrganization;
                output.WindowsRegisteredOwner = regCurVer.RegisteredOwner;
                output.WindowsSystemRoot = regCurVer.SystemRoot;
                output.WindowsVersion = regCurVer.ReleaseId;
                output.WindowsUBR = regCurVer.UBR;
            }

            var os = osInfo.os;
            if (os != null)
            {
                output.OsName = os.Caption;
                output.OsBootDevice = os.BootDevice;
                output.OsBuildNumber = os.BuildNumber;
                output.OsBuildType = os.BuildType;
                output.OsCodeSet = os.CodeSet;
                output.OsCountryCode = os.CountryCode;
                output.OsCSDVersion = os.CSDVersion;
                output.OsCurrentTimeZone = os.CurrentTimeZone;
                output.OsDataExecutionPreventionAvailable = os.DataExecutionPrevention_Available;
                output.OsDataExecutionPrevention32BitApplications = os.DataExecutionPrevention_32BitApplications;
                output.OsDataExecutionPreventionDrivers = os.DataExecutionPrevention_Drivers;
                output.OsDataExecutionPreventionSupportPolicy =
                    EnumConverter<DataExecutionPreventionSupportPolicy>.Convert(os.DataExecutionPrevention_SupportPolicy);
                output.OsDebug = os.Debug;

                output.OsDistributed = os.Distributed;
                output.OsEncryptionLevel = EnumConverter<OSEncryptionLevel>.Convert((int?)os.EncryptionLevel);
                output.OsForegroundApplicationBoost = EnumConverter<ForegroundApplicationBoost>.Convert(os.ForegroundApplicationBoost);
                output.OsTotalSwapSpaceSize = os.TotalSwapSpaceSize;
                output.OsTotalVisibleMemorySize = os.TotalVisibleMemorySize;
                output.OsFreePhysicalMemory = os.FreePhysicalMemory;
                output.OsFreeSpaceInPagingFiles = os.FreeSpaceInPagingFiles;
                output.OsTotalVirtualMemorySize = os.TotalVirtualMemorySize;
                output.OsFreeVirtualMemory = os.FreeVirtualMemory;
                if (os.TotalVirtualMemorySize != null && os.FreeVirtualMemory != null)
                    output.OsInUseVirtualMemory = os.TotalVirtualMemorySize - os.FreeVirtualMemory;
                output.OsInstallDate = os.InstallDate;
                output.OsLastBootUpTime = os.LastBootUpTime;
                output.OsLocalDateTime = os.LocalDateTime;
                output.OsLocaleID = os.Locale;
                output.OsManufacturer = os.Manufacturer;
                output.OsMaxNumberOfProcesses = os.MaxNumberOfProcesses;
                output.OsMaxProcessMemorySize = os.MaxProcessMemorySize;
                output.OsMuiLanguages = os.MUILanguages;
                output.OsNumberOfLicensedUsers = os.NumberOfLicensedUsers;
                output.OsNumberOfProcesses = os.NumberOfProcesses;
                output.OsNumberOfUsers = os.NumberOfUsers;
                output.OsOperatingSystemSKU = EnumConverter<OperatingSystemSKU>.Convert((int?)os.OperatingSystemSKU);
                output.OsOrganization = os.Organization;
                output.OsArchitecture = os.OSArchitecture;
                output.OsLanguage = os.LanguageName;
                output.OsProductSuites = os.ProductSuites;
                output.OsOtherTypeDescription = os.OtherTypeDescription;
                output.OsPAEEnabled = os.PAEEnabled;
                output.OsPortableOperatingSystem = os.PortableOperatingSystem;
                output.OsPrimary = os.Primary;
                output.OsProductType = EnumConverter<ProductType>.Convert((int?)os.ProductType);
                output.OsRegisteredUser = os.RegisteredUser;
                output.OsSerialNumber = os.SerialNumber;
                output.OsServicePackMajorVersion = os.ServicePackMajorVersion;
                output.OsServicePackMinorVersion = os.ServicePackMinorVersion;
                output.OsSizeStoredInPagingFiles = os.SizeStoredInPagingFiles;
                output.OsStatus = os.Status;
                output.OsSuites = os.Suites;
                output.OsSystemDevice = os.SystemDevice;
                output.OsSystemDirectory = os.SystemDirectory;
                output.OsSystemDrive = os.SystemDrive;
                output.OsType = EnumConverter<OSType>.Convert(os.OSType);
                output.OsVersion = os.Version;
                output.OsWindowsDirectory = os.WindowsDirectory;

                output.OsHardwareAbstractionLayer = osInfo.halVersion;
                output.OsLocale = os.GetLocale();
                output.OsUptime = osInfo.upTime;
                output.OsHotFixes = osInfo.hotFixes;

                var pageFileUsage = osInfo.pageFileUsage;
                if (pageFileUsage != null)
                {
                    output.OsPagingFiles = new string[pageFileUsage.Length];

                    for (int i = 0; i < pageFileUsage.Length; i++)
                        output.OsPagingFiles[i] = pageFileUsage[i].Caption;
                }
            }

            var bios = systemInfo.bios;
            if (bios != null)
            {
                output.BiosCharacteristics = bios.BiosCharacteristics;
                output.BiosBuildNumber = bios.BuildNumber;
                output.BiosBIOSVersion = bios.BIOSVersion;
                output.BiosCaption = bios.Caption;
                output.BiosCodeSet = bios.CodeSet;
                output.BiosCurrentLanguage = bios.CurrentLanguage;
                output.BiosDescription = bios.Description;
                output.BiosEmbeddedControllerMajorVersion = bios.EmbeddedControllerMajorVersion;
                output.BiosEmbeddedControllerMinorVersion = bios.EmbeddedControllerMinorVersion;
                output.BiosIdentificationCode = bios.IdentificationCode;
                output.BiosInstallableLanguages = bios.InstallableLanguages;
                output.BiosInstallDate = bios.InstallDate;
                output.BiosLanguageEdition = bios.LanguageEdition;
                output.BiosListOfLanguages = bios.ListOfLanguages;
                output.BiosManufacturer = bios.Manufacturer;
                output.BiosName = bios.Name;
                output.BiosOtherTargetOS = bios.OtherTargetOS;
                output.BiosPrimaryBIOS = bios.PrimaryBIOS;
                output.BiosReleaseDate = bios.ReleaseDate;
                output.BiosSerialNumber = bios.SerialNumber;
                output.BiosSMBIOSBIOSVersion = bios.SMBIOSBIOSVersion;
                output.BiosSMBIOSMajorVersion = bios.SMBIOSMajorVersion;
                output.BiosSMBIOSMinorVersion = bios.SMBIOSMinorVersion;
                output.BiosSMBIOSPresent = bios.SMBIOSPresent;
                output.BiosSoftwareElementState = EnumConverter<SoftwareElementState>.Convert(bios.SoftwareElementState);
                output.BiosStatus = bios.Status;
                output.BiosSystemBiosMajorVersion = bios.SystemBiosMajorVersion;
                output.BiosSystemBiosMinorVersion = bios.SystemBiosMinorVersion;
                output.BiosTargetOperatingSystem = bios.TargetOperatingSystem;
                output.BiosVersion = bios.Version;

                if (otherInfo != null)
                    output.BiosFirmwareType = otherInfo.firmwareType;
            }

            var computer = systemInfo.computer;
            if (computer != null)
            {
                output.CsAdminPasswordStatus = EnumConverter<HardwareSecurity>.Convert(computer.AdminPasswordStatus);
                output.CsAutomaticManagedPagefile = computer.AutomaticManagedPagefile;
                output.CsAutomaticResetBootOption = computer.AutomaticResetBootOption;
                output.CsAutomaticResetCapability = computer.AutomaticResetCapability;
                output.CsBootOptionOnLimit = EnumConverter<BootOptionAction>.Convert(computer.BootOptionOnLimit);
                output.CsBootOptionOnWatchDog = EnumConverter<BootOptionAction>.Convert(computer.BootOptionOnWatchDog);
                output.CsBootROMSupported = computer.BootROMSupported;
                output.CsBootStatus = computer.BootStatus;
                output.CsBootupState = computer.BootupState;
                output.CsCaption = computer.Caption;
                output.CsChassisBootupState = EnumConverter<SystemElementState>.Convert(computer.ChassisBootupState);
                output.CsChassisSKUNumber = computer.ChassisSKUNumber;
                output.CsCurrentTimeZone = computer.CurrentTimeZone;
                output.CsDaylightInEffect = computer.DaylightInEffect;
                output.CsDescription = computer.Description;
                output.CsDNSHostName = computer.DNSHostName;
                output.CsDomain = computer.Domain;
                output.CsDomainRole = EnumConverter<DomainRole>.Convert(computer.DomainRole);
                output.CsEnableDaylightSavingsTime = computer.EnableDaylightSavingsTime;
                output.CsFrontPanelResetStatus = EnumConverter<HardwareSecurity>.Convert(computer.FrontPanelResetStatus);
                output.CsHypervisorPresent = computer.HypervisorPresent;
                output.CsInfraredSupported = computer.InfraredSupported;
                output.CsInitialLoadInfo = computer.InitialLoadInfo;
                output.CsInstallDate = computer.InstallDate;
                output.CsKeyboardPasswordStatus = EnumConverter<HardwareSecurity>.Convert(computer.KeyboardPasswordStatus);
                output.CsLastLoadInfo = computer.LastLoadInfo;
                output.CsManufacturer = computer.Manufacturer;
                output.CsModel = computer.Model;
                output.CsName = computer.Name;
                output.CsNetworkAdapters = systemInfo.networkAdapters;
                output.CsNetworkServerModeEnabled = computer.NetworkServerModeEnabled;
                output.CsNumberOfLogicalProcessors = computer.NumberOfLogicalProcessors;
                output.CsNumberOfProcessors = computer.NumberOfProcessors;
                output.CsProcessors = systemInfo.processors;
                output.CsOEMStringArray = computer.OEMStringArray;
                output.CsPartOfDomain = computer.PartOfDomain;
                output.CsPauseAfterReset = computer.PauseAfterReset;
                output.CsPCSystemType = EnumConverter<PCSystemType>.Convert(computer.PCSystemType);
                output.CsPCSystemTypeEx = EnumConverter<PCSystemTypeEx>.Convert(computer.PCSystemTypeEx);
                output.CsPowerManagementCapabilities = computer.GetPowerManagementCapabilities();
                output.CsPowerManagementSupported = computer.PowerManagementSupported;
                output.CsPowerOnPasswordStatus = EnumConverter<HardwareSecurity>.Convert(computer.PowerOnPasswordStatus);
                output.CsPowerState = EnumConverter<PowerState>.Convert(computer.PowerState);
                output.CsPowerSupplyState = EnumConverter<SystemElementState>.Convert(computer.PowerSupplyState);
                output.CsPrimaryOwnerContact = computer.PrimaryOwnerContact;
                output.CsPrimaryOwnerName = computer.PrimaryOwnerName;
                output.CsResetCapability = EnumConverter<ResetCapability>.Convert(computer.ResetCapability);
                output.CsResetCount = computer.ResetCount;
                output.CsResetLimit = computer.ResetLimit;
                output.CsRoles = computer.Roles;
                output.CsStatus = computer.Status;
                output.CsSupportContactDescription = computer.SupportContactDescription;
                output.CsSystemFamily = computer.SystemFamily;
                output.CsSystemSKUNumber = computer.SystemSKUNumber;
                output.CsSystemType = computer.SystemType;
                output.CsThermalState = EnumConverter<SystemElementState>.Convert(computer.ThermalState);
                output.CsTotalPhysicalMemory = computer.TotalPhysicalMemory;
                output.CsUserName = computer.UserName;
                output.CsWakeUpType = EnumConverter<WakeUpType>.Convert(computer.WakeUpType);
                output.CsWorkgroup = computer.Workgroup;

                if (otherInfo != null)
                {
                    output.CsPhysicallyInstalledMemory = otherInfo.physicallyInstalledMemory;
                }
            }

            if (otherInfo != null)
            {
                output.TimeZone = otherInfo.timeZone;
                output.LogonServer = otherInfo.logonServer;
                output.PowerPlatformRole = otherInfo.powerPlatformRole;

                if (otherInfo.keyboards.Length > 0)
                {
                    //TODO: handle multiple keyboards?
                    // there might be several keyboards found. For the moment
                    // we display info for only one

                    string layout = otherInfo.keyboards[0].Layout;
                    var culture = Conversion.MakeLocale(layout);

                    output.KeyboardLayout = culture == null ? layout : culture.Name;
                }

                if (otherInfo.hyperV != null)
                {
                    output.HyperVisorPresent = otherInfo.hyperV.Present;
                    output.HyperVRequirementDataExecutionPreventionAvailable = otherInfo.hyperV.DataExecutionPreventionAvailable;
                    output.HyperVRequirementSecondLevelAddressTranslation = otherInfo.hyperV.SecondLevelAddressTranslation;
                    output.HyperVRequirementVirtualizationFirmwareEnabled = otherInfo.hyperV.VirtualizationFirmwareEnabled;
                    output.HyperVRequirementVMMonitorModeExtensions = otherInfo.hyperV.VMMonitorModeExtensions;
                }

                output.OsServerLevel = otherInfo.serverLevel;

                var deviceGuardInfo = otherInfo.deviceGuard;
                if (deviceGuardInfo != null)
                {
                    output.DeviceGuardSmartStatus = deviceGuardInfo.status;

                    var deviceGuard = deviceGuardInfo.deviceGuard;
                    if (deviceGuard != null)
                    {
                        output.DeviceGuardRequiredSecurityProperties = deviceGuard.RequiredSecurityProperties;
                        output.DeviceGuardAvailableSecurityProperties = deviceGuard.AvailableSecurityProperties;
                        output.DeviceGuardSecurityServicesConfigured = deviceGuard.SecurityServicesConfigured;
                        output.DeviceGuardSecurityServicesRunning = deviceGuard.SecurityServicesRunning;
                        output.DeviceGuardCodeIntegrityPolicyEnforcementStatus = deviceGuard.CodeIntegrityPolicyEnforcementStatus;
                        output.DeviceGuardUserModeCodeIntegrityPolicyEnforcementStatus = deviceGuard.UserModeCodeIntegrityPolicyEnforcementStatus;
                    }
                }
            }

            return output;
        }

        /// <summary>
        /// Create a new PSObject, containing only those properties named in the
        /// namedProperties parameter
        /// </summary>
        /// <param name="info">
        /// A <see cref="ComputerInfo"/> containing all the acquired system information
        /// </param>
        /// <param name="namedProperties">
        /// A list of property names to be included in the returned object
        /// </param>
        /// <returns>
        /// A new PSObject with the properties specified in the <paramref name="namedProperties"/>
        /// parameter
        /// </returns>
        private static PSObject CreateCustomOutputObject(ComputerInfo info, List<string> namedProperties)
        {
            var rv = new PSObject();

            if (info != null && namedProperties != null && namedProperties.Count > 0)
            {
                // Walk the list of named properties, find a matching property in the
                // info object, and create a new property on the results object
                // with the associated value.
                var type = info.GetType();

                foreach (var propertyName in namedProperties)
                {
                    var propInfo = type.GetProperty(propertyName, BindingFlags.Public | BindingFlags.Instance);

                    if (propInfo != null)
                    {
                        object value = propInfo.GetValue(info);
                        rv.Properties.Add(new PSNoteProperty(propertyName, value));
                    }
                }
            }

            return rv;
        }

        /// <summary>
        /// Get the names of all <see cref="ComputerInfo"/> properties. This is
        /// part of the processes of validating property names provided by the user.
        /// </summary>
        /// <returns></returns>
        private static List<string> GetComputerInfoPropertyNames()
        {
            var rv = new List<string>();
            var type = typeof(ComputerInfo);

            foreach (var prop in type.GetProperties(BindingFlags.Public | BindingFlags.Instance))
                rv.Add(prop.Name);

            return rv;
        }

        /// <summary>
        /// Expand any wild-card patterns into known property names
        /// </summary>
        /// <param name="propertyNames">
        /// List of known property names
        /// </param>
        /// <param name="pattern">
        /// The wild-card pattern used to perform globbing
        /// </param>
        /// <returns></returns>
        private static List<string> ExpandWildcardPropertyNames(List<string> propertyNames, string pattern)
        {
            var rv = new List<string>();

            var wcp = new WildcardPattern(pattern, WildcardOptions.Compiled | WildcardOptions.IgnoreCase);

            foreach (var name in propertyNames)
                if (wcp.IsMatch(name))
                    rv.Add(name);