PassiveInstall.dll-help.xml

<?xml version="1.0" encoding="UTF-8"?>

<helpItems schema="maml" xmlns="http://msh">
  <!-- Updatable Help Version 5.0.3.0 -->

  <!-- Approve commands -->
  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Approve-PassiveElevation</command:name>
      <maml:description>
        <maml:para>Checks if elevation present, optionally elevating if needed.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Approve</command:verb>
      <command:noun>PassiveElevation</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Approve-PassiveElevation will check to see if the process is elevated.  With the -AsAdmin switch set, if needed it will restart the process and your script (including arguments and working directory) using a RunAsAdmin. If elevation is performed, this copy of your script will be terminated. Typically this is the first cmdlet called in your script when you need to ensure elevation.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Approve-PassiveElevation</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="false">
          <maml:name>AsAdmin</maml:name>
          <maml:description>
            <maml:para>When specified, restart process with RunAs if required.  Otherwise just report current elevation.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="false">
        <maml:name>AsAdmin</maml:name>
        <maml:description>
          <maml:para>When specified, restart process with RunAs if required. Otherwise just report current elevation.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="false" required="false">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None.</maml:name>
          <maml:uri></maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Approve-PassiveElevation.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Boolean.</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>Indicates if elevation is (now) present</maml:para>
          </maml:description>
        </dev:type>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Checks elevation and elevates if needed.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Approve-PassiveElevation -AsAdmin
PS>
        </command:code>
        <dev:remarks>
          <maml:para>The current elevation level is checked.</maml:para>
          <maml:para>If the -AsAdmin switch is used and elevation is needed, the script will be restarted in a new process using RunAs, then this copy of the script is terminated after the relaunched script terminates.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  <!-- Copy commands -->
  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Copy-PassiveFile</command:name>
      <maml:description>
        <maml:para>Copies a file to the given location.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Copy</command:verb>
      <command:noun>PassiveFile</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>
        Copy-PassiveFile will copy the provided file to the folder specified.
        <maml:para>WhatIf and Confirm are supported.</maml:para>
      </maml:para>
      <maml:para>
        If the parent folders for the destination do not exist, they will be created.
        The file copied will use the same name unless a new filename is provided in the optional parameter.
        By default, an existing file will be overwritten, but you may prevent this with the NoOverWrite switch parameter.
      </maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Copy-PassiveFile</maml:name>
        <command:parameter aliases="File" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Source</maml:name>
          <maml:description>
            <maml:para>Full path to the source file to be copied.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false"  required="true">
          <maml:name>Destination</maml:name>
          <maml:description>
            <maml:para>Destination folder that the file will be copied into.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="2" pipelineInput="false" globbing="false"  required="false">
          <maml:name>NewName</maml:name>
          <maml:description>
            <maml:para>If supplied, the filename of the source will be renamed to use this name when copied.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="3" pipelineInput="false" globbing="false" required="false">
          <maml:name>NoOverWrite</maml:name>
          <maml:description>
            <maml:para>When specified, if the destination file exists, do not overwrite it.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="File" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Source</maml:name>
        <maml:description>
          <maml:para>Full path to the source file to be copied.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>

      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
        <maml:name>Destination</maml:name>
        <maml:description>
          <maml:para>Full path to the destination folder where the file will be copied. The folder structure will be created, if necessary.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>

      <command:parameter aliases="none" position="2" pipelineInput="false" globbing="false" required="false">
        <maml:name>NewName</maml:name>
        <maml:description>
          <maml:para>If not speified, the original filename will be used for the copy.  When specified, the filename of the copy is renamed to the value of this parameter.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>

      <command:parameter aliases="none" position="3" pipelineInput="false" globbing="false" required="false">
        <maml:name>NoOverWrite</maml:name>
        <maml:description>
          <maml:para>When specified, aborts the copy if the destination file exists. Otherwise the default behavior is to overwrite.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="false" required="false">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>

    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Copy-PassiveFile.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are file not found and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Copies a file without renaming</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Copy-PassiveFile -Source '\\server\share name\TMurgent_TestDirectory\TestDirectory.exe' -Destination "$($env:ProgramFiles)\TMurgent"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>If the destination folder does not exist, it will be created.</maml:para>
          <maml:para>A copy of the file TestDirectory.exe will be placed in the destination folder.</maml:para>
          <maml:para>If a file of that name already exists at the destination, it will be overwritten.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

      <command:example>
        <maml:title>-------------- EXAMPLE 2 --------------</maml:title>
        <maml:introduction>
          <maml:para>Copies a file, renaming the copied file along the way.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Copy-PassiveFile -Source '\\server\share name\TMurgent_TestDirectory\TestDirectory.exe' -Destination "$($env:ProgramFiles)\TMurgent" -NewName "FunkyMonkey.exe"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>If the destination folder does not exist, it will be created.</maml:para>
          <maml:para>A copy of the file TestDirectory.exe will be placed in the destination folder using the new name.</maml:para>
          <maml:para>If a file of that new name already exists at the destination, it will be overwritten.</maml:para>
          <maml:para>If a file of the old name already exists at the destination, it will not be touched.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Copy-PassiveFolder</command:name>
      <maml:description>
        <maml:para>Copies a folder (and its contents) to the given location.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Copy</command:verb>
      <command:noun>PassiveFolder</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Copy-PassiveFolder will copy the provided source folder, and contents, to the destination folder specified. If the destination folder does not exist it will be created.  The source folder will be copied under the destination.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Copy-PassiveFolder</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Source</maml:name>
          <maml:description>
            <maml:para>Full path to the source folder to be copied.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false"  required="true">
          <maml:name>Destination</maml:name>
          <maml:description>
            <maml:para>Destination folder that the source folder will be copied into.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="2" pipelineInput="false" globbing="false" required="false">
          <maml:name>Overwrite</maml:name>
          <maml:description>
            <maml:para>When specified, if the destination file exists, do overwrite it.  If the file is in use, make a temporary copy and add a RunOnce key to complete the operation on next reboot.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Source</maml:name>
        <maml:description>
          <maml:para>Full path to the source folder to be copied.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
        <maml:name>Destination</maml:name>
        <maml:description>
          <maml:para>Full path to the destination folder where the source folder will be copied. The folder structure will be created, if necessary.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="2" pipelineInput="false" globbing="false" required="false">
        <maml:name>OverWrite</maml:name>
        <maml:description>
          <maml:para>When specified, overwrite the file if the destination file exists. Otherwise the default behavior is to NOT overwrite.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="false" required="false">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Copy-PassiveFolder.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are folder not found and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Copies a folder</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Copy-PassiveFolder -Source '\\server\share name\TMurgent_TestDirectory' -Destination "$($env:ProgramFiles)\TMurgent"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>If the destination folder does not exist, it will be created.</maml:para>
          <maml:para>A copy of the folder TMurgent_TestDirectory.exe will be placed in the destination folder; such as C:\Program Files\TMurgent\TMurgent_TestDirectory</maml:para>
          <maml:para>If a folder of that name TMurgent_TestDirectory already exists at the destination, it will be overwritten using a merge technique.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>


  <!-- Disable commands -->
  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Disable-PassiveWindowsServices</command:name>
      <maml:description>
        <maml:para>Sets each listed windows service in the Disabled state.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Disable</command:verb>
      <command:noun>PassiveWindowsServices</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Disable-PassiveWindowsServices will set the startup state of each of the requested Windows Services to Disabled.  It does not stop the running service(s).</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Disable-PassiveWindowsServices</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Names</maml:name>
          <maml:description>
            <maml:para>A list of service names.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Names</maml:name>
        <maml:description>
          <maml:para>A list of names of installed Windows Services.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String[]</command:parameterValue>
        <dev:type>
          <maml:name>String[]</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Disable-PassiveWindowsServices.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are service not found and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Disables a service</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Disable-PassiveWindowsServices -Names 'CrummyVendorUpdaterService'
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Use the 'Service Name' and not the 'Display Name' when naming a service.</maml:para>
          <maml:para>If the service is currently running, this cmdlet will not automatically stop it, but it will be set to disabled.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>


      <command:example>
        <maml:title>-------------- EXAMPLE 2 --------------</maml:title>
        <maml:introduction>
          <maml:para>Disables a list of services</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Disable-PassiveWindowsServices -Names "'CrummyVendorUpdaterService', 'AudioEndpointBuilder'"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Use the 'Service Name' and not the 'Display Name' when naming a service.</maml:para>
          <maml:para>If the service is currently running, this cmdlet will not automatically stop it, but it will be set to disabled.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  <!-- Get commands -->
  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Get-PassiveFirewallRules</command:name>
      <maml:description>
        <maml:para>Retrieve a structure that contains the current registry entries for the Windows Firewall.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Get</command:verb>
      <command:noun>PassiveFirewallRules</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Get-PassivePassiveFirewallRules will return a structure consisting of all the Defaults and Parameters of the Windows Firewall rules from the registry.</maml:para>
      <maml:para>The typical use is to run this command both before and after an application installation, and to pass the snapshots to the Redo-PassiveNewFirewallRules cmdlet.</maml:para>
      <maml:para>The Microsoft MSIX Packaging tool will not capture firewall rules added by the application installer.  It is a built in filter that we cannot configure.  By taking before and after snapshots, you can then ask the Redo cmdlet to re-write the registry entries so that they will be captured.</maml:para>
    </maml:description>
    
    <command:syntax>
      <command:syntaxItem>
        <maml:name>Get-PassiveFirewallRules</maml:name>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters/>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
        </dev:type><maml:description>
          <maml:para>You cannot pipe objects to Get-PassiveFirewallRules.</maml:para>
        </maml:description>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>PassiveInstall.Structures.FirewallRules</maml:name>
          <maml:uri> </maml:uri>
        </dev:type>
        <maml:description>
          <maml:para>The rules from the registry.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>No errors should occur on a healthy system.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>This is a typical usage scenario:</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> $BeforeSnapshot = Get-PassiveFirewallRules
PS> msiexec /q vendorInstaller.msi
PS> $AfterSnapshot = Get-PassiveFirewallRules
PS> $Changes = Redo-PassiveNewFirewallRules $BeforeSnapshot $AfterSnapshot
PS> $Changes.Show()
PS>
        </command:code>    

        <dev:remarks>
          <maml:para></maml:para>
          <maml:para>The scenario is an application installation for which we want any firewall rules added by the vendor installer to be properly captured by the MMPT.</maml:para>
          <maml:para>    1) Before the application installation a snapshot is saved.</maml:para>
          <maml:para>    2) The application installer is run.</maml:para>
          <maml:para>    3) After the application installation, a second snapshort is saved.</maml:para>
          <maml:para>    4) Then the Redo cmdlet is run to re-apply any new firewall rules added by the installer.</maml:para>
          <maml:para>    5) For giggles, the rules that were re-applied are displayed using the Show() method on the output object.</maml:para>
          <maml:para></maml:para>
          <maml:para>Only rules that are new in the after snapshot will be updated.</maml:para>
        </dev:remarks>
      </command:example>

    </command:examples>
  </command:command>



  <!-- Install commands -->
  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Install-PassiveInstallFile</command:name>
      <maml:description>
        <maml:para>Performs the appropriate installation activity on the file provided.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Install</command:verb>
      <command:noun>PassiveInstallFile</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Install-PassiveInstallFile determines the appropriate action to take on the supplied file to install the file.</maml:para>
      <maml:para>The Action to be taken depends on the file extension, and additional parameters to this cmdlet allow you to control the installation activity even more.</maml:para>
      <maml:para>The file types currently supported are:</maml:para>
      <maml:para>    MSI - The msiexec.exe system command will be used to perform the installation using the /install option.  If any arguments are provided, these will be added to the command line.</maml:para>
      <maml:para>    MSP - The msiexec.exe system command will be used to perform the installation update using the /update option. If any arguments are provided, these will be added to the command line.</maml:para>
      <maml:para>    EXE - The command will be directly run, using any arguments provided as command line arguments.</maml:para>
      <maml:para>    ZIP - The zip compressed file will be extracted under the directory specified as an argument to this cmdlet.  If that folder does not currently exist it will be created. Password protected zip archives are not supported.</maml:para>
      <maml:para>    PS1 - The PowerShell file will be run in a new PowerShell session/window using the ByPass option.</maml:para>
      <maml:para>    BAT - The BAT file will be run using cmd.exe with the /c option, plus any arguments provided to this cmdlet.</maml:para>
      <maml:para>    CMD - The CMD file will be run using cmd.exe with the /c option, plus any arguments provided to this cmdlet.</maml:para>
      <maml:para>    REG - The REG file will be imported to the Windows Registry using the reg.exe program. Any arguments supplied are silently ignored.</maml:para>
      <maml:para></maml:para>
      <maml:para>Each of these actions create a new window to perform the installation.  By default the window is visible, but the DoSilent flag will hide the window.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Install-PassiveInstallFile</maml:name>
        <command:parameter aliases="File" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Installer</maml:name>
          <maml:description>
            <maml:para>Filepath of a file to be installed.  Must be a file of type Msi, Msp, Exe, Zip, Ps1, Bat, Cmd, or Reg.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="Destination" position="1" pipelineInput="false" globbing="false" required="false">
          <maml:name>Arguments</maml:name>
          <maml:description>
            <maml:para>Except if Installer is a Zip or Reg file, these arguments are appended to the installation command line.</maml:para>
            <maml:para>If the installer is a Zip file, this parameter is the destination folder to unpack into.</maml:para>
            <maml:para>Reg Installers ignore this parameter if set.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="none" pipelineInput="false" globbing="false" required="false">
          <maml:name>AllowedErrorCodes</maml:name>
          <maml:description>
            <maml:para>This cmdlet will interpret the error code returned by the installer process when it exits.</maml:para>
            <maml:para>By default, a 0 and 3010 (0xBC2) are treated as non-errors.</maml:para>
            <maml:para>Error codes entered in this list will also be treated as non-errors.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="none" pipelineInput="false" globbing="false" required="false">
          <maml:name>DoSilent</maml:name>
          <maml:description>
            <maml:para>This cmdlet produces additional windows to perform the installation. This option will hide the window.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="none" pipelineInput="false" globbing="false" required="false">
          <maml:name>DoPassive</maml:name>
          <maml:description>
            <maml:para>This cmdlet produces additional windows to perform the installation. This option will allow the window to be seen.  This is the default.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="File" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Installer</maml:name>
        <maml:description>
          <maml:para>Filepath of a file to be installed.  Must be a file of type Msi, Msp, Exe, Zip, Ps1, Bat, Cmd, or Reg.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="Destination" position="1" pipelineInput="false" globbing="false" required="false">
        <maml:name>Arguments</maml:name>
        <maml:description>
          <maml:para>Except if Installer is a Zip or Reg file, these arguments are appended to the installation command line.</maml:para>
          <maml:para>If the installer is a Zip file, this parameter is the destination folder to unpack into.</maml:para>
          <maml:para>Reg Installers ignore this parameter if set.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="none" pipelineInput="false" globbing="false" required="false">
        <maml:name>AllowedErrorCodes</maml:name>
        <maml:description>
          <maml:para>This cmdlet will interpret the error code returned by the installer process when it exits.</maml:para>
          <maml:para>By default, a 0 and 3010 (0xBC2) are treated as non-errors.</maml:para>
          <maml:para>Error codes entered in this list will also be treated as non-errors.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">Int[]</command:parameterValue>
        <dev:type>
          <maml:name>Int[]</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="none" pipelineInput="false" globbing="false" required="false">
        <maml:name>DoSilent</maml:name>
        <maml:description>
          <maml:para>This cmdlet produces additional windows to perform the installation. This option will hide the window.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
      </command:parameter>
      <command:parameter aliases="none" position="none" pipelineInput="false" globbing="false" required="false">
        <maml:name>DoPassive</maml:name>
        <maml:description>
          <maml:para>This cmdlet produces additional windows to perform the installation. This option will allow the window to be seen.  This is the default.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Install-PassiveInstallFile.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are file not found and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Install a MSI</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Install-PassiveInstallFile -Installer 'C:\InstallSource\Vendor.msi' -Arguments '/qn SOMEOPTION=7'
PS>
        </command:code>
        <dev:code>PS C:\>Install-PassiveInstallFile -Installer 'C:\InstallSource\Vendor.msi' -Arguments '/qn SOMEOPTION=7' </dev:code>
        <dev:remarks>
          <maml:para>msiexec.exe will be used to install the file.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>


      <command:example>
        <maml:title>-------------- EXAMPLE 2 --------------</maml:title>
        <maml:introduction>
          <maml:para>Patch an install with a MSP file</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Install-PassiveInstallFile -Installer 'C:\InstallSource\Vendor.msp' -Arguments '/qn'
PS>
        </command:code>
        <dev:remarks>
          <maml:para>msiexec.exe will be used to install the patch.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>



      <command:example>
        <maml:title>-------------- EXAMPLE 3 --------------</maml:title>
        <maml:introduction>
          <maml:para>Install using an exe based installer and fully silent.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Install-PassiveInstallFile -Installer 'C:\InstallSource\Vendor.exe' -Arguments '/silent' -DoSilent
PS>
        </command:code>
        <dev:remarks>
          <maml:para>The exe will be directly executed. Arguments for a silent or passive install are vendor specific.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>



      <command:example>
        <maml:title>-------------- EXAMPLE 4 --------------</maml:title>
        <maml:introduction>
          <maml:para>Install with a ZIP file</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Install-PassiveInstallFile -Installer 'C:\InstallSource\Vendor.zip' -Destination 'C:\Program Files\Vendor'
PS>
        </command:code>
        <dev:remarks>
          <maml:para>The windows internal zip utility will be used to extract the content of the zip file and place into the destination folder.</maml:para>
          <maml:para>In this case, no new process or window is created, so the DoSilent option is ignored.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>



      <command:example>
        <maml:title>-------------- EXAMPLE 5 --------------</maml:title>
        <maml:introduction>
          <maml:para>Install with a CMD or BAT file</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Install-PassiveInstallFile -Installer 'C:\InstallSource\Vendor.cmd' -Arguments 'SomeOption="this"'
PS>
        </command:code>
        <dev:remarks>
          <maml:para>The windows cmd.exe command will be used with the /c option to run the cmd or bat file.  The Arguments parameters will be appended to the command line.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>




      <command:example>
        <maml:title>-------------- EXAMPLE 6 --------------</maml:title>
        <maml:introduction>
          <maml:para>Install with a REG file.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Install-PassiveInstallFile -Installer 'C:\InstallSource\Custom.Reg'
PS>
        </command:code>
        <dev:remarks>
          <maml:para>The windows reg.exe command will be used to import the Reg file into the Windows Registry.  The Arguments parameters will be ignored, if present.</maml:para>
          <maml:para>The force and silent options are automatically used to prevent popups.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

    </command:examples>
  </command:command>


  <!-- Move Commands -->
  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Move-PassiveFolder</command:name>
      <maml:description>
        <maml:para>Moves the source folder under the destination.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Move</command:verb>
      <command:noun>PassiveFolder</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Move-PassiveFolder will move the source folder underneath the destination folder.  The destination folder will automatically be created if not present.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Move-PassiveFolder</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Source</maml:name>
          <maml:description>
            <maml:para>The path for the folder to be moved.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
          <maml:name>Destination</maml:name>
          <maml:description>
            <maml:para>The path for the folder which the Source will be moved under.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Source</maml:name>
        <maml:description>
          <maml:para>The path for the folder to be moved.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
        <maml:name>Destination</maml:name>
        <maml:description>
          <maml:para>The path for the folder which the Source will be moved under.</maml:para>
          <maml:para>This folder will be created if not present.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Move-PassiveFolder.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are folder not found and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Move a folder</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Move-PassiveFolder -Source 'C:\Downloads\Mytempfolder\PlugIns' -Destination '"C:\Program Files (x86)\Vendor\Product"'
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Moves the requested folder.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Move-PassiveRegistryKey</command:name>
      <maml:description>
        <maml:para>Moves the source Key under the destination Key.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Move</command:verb>
      <command:noun>PassiveRegistryKey</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Move-PassiveRegistryKey will move the source key underneath the destination key.  Typically used to move HKLM to HKCU.</maml:para>
      <maml:para>The destination key will automatically be created if not present.</maml:para>
      <maml:para></maml:para>
      <maml:para>This cmdlet is used most often to move keys between hives.  For example, if an installer does not provide a per-user install option you can move the file type associations and COM registrations into the current user hive after installation.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Move-PassiveRegistryKey</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>FromHive</maml:name>
          <maml:description>
            <maml:para>The hive of the key to be moved, such as HKLM or HKCU.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
          <maml:name>ParentKey</maml:name>
          <maml:description>
            <maml:para>The path for the key which acts as the Source to be moved.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="2" pipelineInput="false" globbing="false" required="true">
          <maml:name>RelativeKey</maml:name>
          <maml:description>
            <maml:para>The path for the key as it will be moved.  Normally this is the same as ParentKey.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="3" pipelineInput="false" globbing="false" required="true">
          <maml:name>ToHive</maml:name>
          <maml:description>
            <maml:para>The hive of the key to be moved to, such as HKLM or HKCU.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>FromHive</maml:name>
        <maml:description>
          <maml:para>The hive of the key to be moved, such as HKLM or HKCU.</maml:para>
          <maml:para>The list of valid hives supported are HKCR, HKCC, HKCU, HKLM or HKPD, and HKUS.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
        <maml:name>ParentKey</maml:name>
        <maml:description>
          <maml:para>The path for the key which acts as the Source to be moved.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="2" pipelineInput="false" globbing="false" required="true">
        <maml:name>RelativeKey</maml:name>
        <maml:description>
          <maml:para>The path for the key as it will be moved.  Normally this is the same as ParentKey.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="3" pipelineInput="false" globbing="false" required="true">
        <maml:name>ToHive</maml:name>
        <maml:description>
          <maml:para>The hive of the key to be moved to, such as HKLM or HKCU.</maml:para>
          <maml:para>The list of valid hives supported are HKCR, HKCC, HKCU, HKLM or HKPD, and HKUS.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Move-PassiveRegistryKey.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are key not found, invalid syntax to identigy a hive, and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Move a file type association from the local machine to current user hive</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Move-PassiveRegistryKey -FromHive 'HKLM' -ParentKey 'Software\Classes\.xyz' -RelativeKey 'Software\Classes\.xyz' -ToHive 'HKCU'
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Moves the requested key.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>


  <!-- New Commands -->
  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>New-PassiveAppPathSearch</command:name>
      <maml:description>
        <maml:para>Creates/Updates an AppPath entry for Windows Start Menu search.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>New</command:verb>
      <command:noun>PassiveAppPathSearch</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>New-PassiveAppPathSearch will register the application for windows start menu search.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
      <maml:para></maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>New-PassiveAppPathSearch</maml:name>
        <command:parameter aliases="TargetPath" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Target</maml:name>
          <maml:description>
            <maml:para>The target program or file to link to the search keyword.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
          <maml:name>Alias</maml:name>
          <maml:description>
            <maml:para>Optional alias to use for the search term.  When not specified, the name of the executable is used.  For example, if you type "write" in the start menu it will come up with wordpad because write.exe is registerd as an alias.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="TargetPath" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Target</maml:name>
        <maml:description>
          <maml:para>The target program or file to link to the search keyword.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
        <maml:name>Alias</maml:name>
        <maml:description>
          <maml:para>Optional alias to use for the search term.  When not specified, the name of the executable is used.  For example, if you type "write" in the start menu it will come up with wordpad because write.exe is registerd as an alias.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to New-PassiveAppPathSearch.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are target file or Icon file not found, and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Creates a search entry for the application in the start menu.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> New-PassiveAppPathSearch -Target "$($env:ProgramFiles)\Vendor\Product\file.exe"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Creates or updates the requested search entry.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>


  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>New-PassiveDesktopShortcut</command:name>
      <maml:description>
        <maml:para>Creates a shortcut to the current user's desktop.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>New</command:verb>
      <command:noun>PassiveDesktopShortcut</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>New-PassiveDesktopShortcut will create a shortcut on the current user's desktop as specified.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
      <maml:para></maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>New-PassiveDesktopShortcut</maml:name>
        <command:parameter aliases="Target" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>TargetPath</maml:name>
          <maml:description>
            <maml:para>The target program or file that the lnk file points to.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="Shortcut" position="1" pipelineInput="false" globbing="false" required="true">
          <maml:name>ShortcutName</maml:name>
          <maml:description>
            <maml:para>The name of the shortcut file, either with or without the .lnk file type extensions. Do not include the path.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="Args,Argument" position="2" pipelineInput="false" globbing="false" required="false">
          <maml:name>Arguments</maml:name>
          <maml:description>
            <maml:para>Command line arguments (parameters) to be used when the shortcut is invoked.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="Desc" position="3" pipelineInput="false" globbing="false" required="false">
          <maml:name>Description</maml:name>
          <maml:description>
            <maml:para>The description is stored in the shortcut and displayed as a tooltip to users if they hover the mouse over the shortcut.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="WorkingDirectory,WorkingDir" position="4" pipelineInput="false" globbing="false" required="false">
          <maml:name>WorkDir</maml:name>
          <maml:description>
            <maml:para>The working directory for the program run when the end-user invokes the shortcut.</maml:para>
            <maml:para>When not specified, the new process will use the directory of the process executable as the working directory.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="5" pipelineInput="false" globbing="false" required="false">
          <maml:name>Icon</maml:name>
          <maml:description>
            <maml:para>Path to a file contiaining an icon.  In the case of PE formatted executable files with multiple icons embedded as resources, you can append a comma and resource icon index (i.e. "c:\path\foo.exe,2").</maml:para>
            <maml:para>When not specified the shortcut will have an icon extracted from the target, if possible.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="6" pipelineInput="false" globbing="false" required="false">
          <maml:name>WindowStyle</maml:name>
          <maml:description>
            <maml:para>Optional Window Style of resulting window when the end-user invokes the shortcut. </maml:para>
            <maml:para>Supported values: 1=Normal 3=Maximized 7=Minimized.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="7" pipelineInput="false" globbing="false" required="false">
          <maml:name>HotKey</maml:name>
          <maml:description>
            <maml:para>Optional hotkey to trigger the shortcut. </maml:para>
            <maml:para>Example: \"Ctrl+Alt+e\".</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="RunAsAdmin" position="8" pipelineInput="false" globbing="false" required="false">
          <maml:name>Admin</maml:name>
          <maml:description>
            <maml:para>Optional switch to indicate that the shortcut should have the RunAsAdministrator property set.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter  position="9" pipelineInput="false" globbing="false" required="false">
          <maml:name>CurrentUser</maml:name>
          <maml:description>
            <maml:para>Optional switch to indicate that the shortcut should be created on the the current user's desktop instead of the public (all users) desktop.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="Target" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>TargetPath</maml:name>
        <maml:description>
          <maml:para>The target program or file that the lnk file points to.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="Shortcut" position="1" pipelineInput="false" globbing="false" required="true">
        <maml:name>ShortcutName</maml:name>
        <maml:description>
          <maml:para>The name of the shortcut file, either with or without the .lnk file type extensions. Do not include the path.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="Args,Argument" position="2" pipelineInput="false" globbing="false" required="false">
        <maml:name>Arguments</maml:name>
        <maml:description>
          <maml:para>Command line arguments (parameters) to be used when the shortcut is invoked.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="Desc" position="3" pipelineInput="false" globbing="false" required="false">
        <maml:name>Description</maml:name>
        <maml:description>
          <maml:para>The description is stored in the shortcut and displayed as a tooltip to users if they hover the mouse over the shortcut.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="WorkingDirectory,WorkingDir" position="4" pipelineInput="false" globbing="false" required="false">
        <maml:name>WorkDir</maml:name>
        <maml:description>
          <maml:para>The working directory for the program run when the end-user invokes the shortcut.</maml:para>
          <maml:para>When not specified, the new process will use the directory of the process executable as the working directory.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="5" pipelineInput="false" globbing="false" required="false">
        <maml:name>Icon</maml:name>
        <maml:description>
          <maml:para>Path to a file contiaining an icon.  In the case of PE formatted executable files with multiple icons embedded as resources, you can append a comma and resource icon index (i.e. "c:\path\foo.exe,2").</maml:para>
          <maml:para>When not specified the shortcut will have an icon extracted from the target, if possible.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="6" pipelineInput="false" globbing="false" required="false">
        <maml:name>WindowStyle</maml:name>
        <maml:description>
          <maml:para>Optional Window Style of resulting window when the end-user invokes the shortcut. </maml:para>
          <maml:para>Supported values: 1=Normal 3=Maximized 7=Minimized.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">Int</command:parameterValue>
        <dev:type>
          <maml:name>Int</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="7" pipelineInput="false" globbing="false" required="false">
        <maml:name>HotKey</maml:name>
        <maml:description>
          <maml:para>Optional hotkey to trigger the shortcut. </maml:para>
          <maml:para>Example: \"Ctrl+Alt+e\".</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="RunAsAdmin" position="8" pipelineInput="false" globbing="false" required="false">
        <maml:name>Admin</maml:name>
        <maml:description>
          <maml:para>Optional switch to indicate that the shortcut should have the RunAsAdministrator property set.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to New-PassiveDesktopShortcut.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are target file or Icon file not found, and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Creates a shortcut on the desktop.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> New-PassiveDesktopShortcut -Target "$($env:ProgramFiles)\Vendor\Product\file.exe" -Shortcut "File" -Icon "$($env:ProgramFiles)\Vendor\Product\file.exe,2"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Creates the requested shortcut on the current user's desktop.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>New-PassiveEnvironmentVariable</command:name>
      <maml:description>
        <maml:para>Creates a new environment variable or changes the value to an existing one..</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>New</command:verb>
      <command:noun>PassiveEnvironmentVariable</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>New-PassiveEnvironmentVariable will change the value of an existing environment variable or create a new one with the value.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
      <maml:para></maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>New-PassiveEnvironmentVariable</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Name</maml:name>
          <maml:description>
            <maml:para>The name of the variable to be created/updated.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
          <maml:name>Value</maml:name>
          <maml:description>
            <maml:para>The value to place in the variable.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Name</maml:name>
        <maml:description>
          <maml:para>The Name of the Environment Variable.</maml:para>
          <maml:para>If the variable already exists, the existing value will be replaced, otherwise a new variable is created.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
        <maml:name>Value</maml:name>
        <maml:description>
          <maml:para>The value to store in the variable.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to New-PassiveEnvironmentVariable.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Create a new variable</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> New-PassiveEnvironmentVariable -Name 'Pokino' -Value '9x9'
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Creates or Updates the requested variable.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

      <command:example>
        <maml:title>-------------- EXAMPLE 2 --------------</maml:title>
        <maml:introduction>
          <maml:para>Updating the Path variable</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> New-PassiveEnvironmentVariable -Name 'PATH' -Value "$($env:PATH);C:\otherfolder"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Appends a new folder to the end of the current path environment variable.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

    </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>New-PassiveFolderIfNotPresent</command:name>
      <maml:description>
        <maml:para>Creates a folder if it is not already present on the system.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>New</command:verb>
      <command:noun>PassiveFolderIfNotPresent</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>New-PassiveFolderIfNotPresent will check if a folder exists, and if not it creates it.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>New-PassiveFolderIfNotPresent</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Folder</maml:name>
          <maml:description>
            <maml:para>Full path to the folder to be created.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Folder</maml:name>
        <maml:description>
          <maml:para>Full path to the folder to be created.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to New-PassiveFolderIfNotPresent.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Copies a folder</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> New-PassiveFolderIfNotPresent -Folder "$($env:ProgramFiles)\TMurgent"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>If the folder does not exist, it will be created.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>New-PassiveRegistryKeyIfNotPresent</command:name>
      <maml:description>
        <maml:para>Creates a registry key if it is not already present on the system.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>New</command:verb>
      <command:noun>PassiveRegistryKeyIfNotPresent</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>New-PassiveRegistryKeyIfNotPresent will check if a key exists, and if not it creates it.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>New-PassiveFolderIfNotPresent</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Hive</maml:name>
          <maml:description>
            <maml:para>Registry Hive to use.</maml:para>
            <maml:para>The list of valid hives supported are HKCR, HKCC, HKCU, HKLM or HKPD, and HKUS.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Key</maml:name>
          <maml:description>
            <maml:para>Full path to the Key to be created.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Hive</maml:name>
        <maml:description>
          <maml:para>Registry Hive to use.</maml:para>
          <maml:para>The list of valid hives supported are HKCR, HKCC, HKCU, HKLM or HKPD, and HKUS.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
        <maml:name>Key</maml:name>
        <maml:description>
          <maml:para>Full path to the key to be created.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to New-PassiveRegistryKeyIfNotPresent.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Copies a folder</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> New-PassiveRegistryKeyIfNotPresent -HIve 'HKLM' -Key "Software\TMurgent\IWillCrash"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>If the key does not exist, it will be created.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>New-PassiveStartMenuShortcut</command:name>
      <maml:description>
        <maml:para>Creates a shortcut to the Start Menu.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>New</command:verb>
      <command:noun>PassiveStartMenuShortcut</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>New-PassiveStartmenuShortcut will create a shortcut on the start menu as specified.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
      <maml:para></maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>New-PassiveStartMenuShortcut</maml:name>
        <command:parameter aliases="Target" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>TargetPath</maml:name>
          <maml:description>
            <maml:para>The target program or file that the lnk file points to.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="Shortcut" position="1" pipelineInput="false" globbing="false" required="true">
          <maml:name>ShortcutName</maml:name>
          <maml:description>
            <maml:para>The name of the shortcut file, either with or without the .lnk file type extensions. Do not include the path.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="Folder" position="2" pipelineInput="false" globbing="false" required="false">
          <maml:name>ShortcutFolder</maml:name>
          <maml:description>
            <maml:para>The name of the folder (structure) that the shortcut should be placed. In most cases you should start this as "Programs\foldername"</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="Args,Argument" position="3" pipelineInput="false" globbing="false" required="false">
          <maml:name>Arguments</maml:name>
          <maml:description>
            <maml:para>Command line arguments (parameters) to be used when the shortcut is invoked.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="Desc" position="4" pipelineInput="false" globbing="false" required="false">
          <maml:name>Description</maml:name>
          <maml:description>
            <maml:para>The description is stored in the shortcut and displayed as a tooltip to users if they hover the mouse over the shortcut.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="WorkingDirectory,WorkingDir" position="5" pipelineInput="false" globbing="false" required="false">
          <maml:name>WorkDir</maml:name>
          <maml:description>
            <maml:para>The working directory for the program run when the end-user invokes the shortcut.</maml:para>
            <maml:para>When not specified, the new process will use the directory of the process executable as the working directory.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="6" pipelineInput="false" globbing="false" required="false">
          <maml:name>Icon</maml:name>
          <maml:description>
            <maml:para>Path to a file contiaining an icon.  In the case of PE formatted executable files with multiple icons embedded as resources, you can append a comma and resource icon index (i.e. "c:\path\foo.exe,2").</maml:para>
            <maml:para>When not specified the shortcut will have an icon extracted from the target, if possible.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="7" pipelineInput="false" globbing="false" required="false">
          <maml:name>WindowStyle</maml:name>
          <maml:description>
            <maml:para>Optional Window Style of resulting window when the end-user invokes the shortcut. </maml:para>
            <maml:para>Supported values: 1=Normal 3=Maximized 7=Minimized.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="8" pipelineInput="false" globbing="false" required="false">
          <maml:name>HotKey</maml:name>
          <maml:description>
            <maml:para>Optional hotkey to trigger the shortcut. </maml:para>
            <maml:para>Example: \"Ctrl+Alt+e\".</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="9" pipelineInput="false" globbing="false" required="false">
          <maml:name>CurrentUser</maml:name>
          <maml:description>
            <maml:para>Optional switch to indicate that the shortcut should be placed in the Current User profile and not for all users.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="RunAsAdmin" position="9" pipelineInput="false" globbing="false" required="false">
          <maml:name>Admin</maml:name>
          <maml:description>
            <maml:para>Optional switch to indicate that the shortcut should have the RunAsAdministrator property set.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="Target" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>TargetPath</maml:name>
        <maml:description>
          <maml:para>The target program or file that the lnk file points to.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="Shortcut" position="1" pipelineInput="false" globbing="false" required="true">
        <maml:name>ShortcutName</maml:name>
        <maml:description>
          <maml:para>The name of the shortcut file, either with or without the .lnk file type extensions. Do not include the full path to the shortcut here, but you can include a relative one.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="Folder" position="2" pipelineInput="false" globbing="false" required="false">
        <maml:name>ShortcutFolder</maml:name>
        <maml:description>
          <maml:para>The name of the folder (structure) that the shortcut should be placed.</maml:para>
          <maml:para>If not specified, the lnk file is placed at the start menu root (All Users or Current User if CurrentUser switch is provided).</maml:para>
          <maml:para>If specified, the lnk file is placed in this folder.</maml:para>
          <maml:para>You may provide the fully qualified path to the folder, or just a relative path.</maml:para>
          <maml:para>If a relative path provided, by default the shortcut is placed in this path under the All Users Profile "Start Menu\Programs" folder.</maml:para>
          <maml:para>If a relative path provided, and the CurrentUser swtich is given, it will be placed under the  Current Users's Roaming profile "Start Menu\Programs" folder.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="Args,Argument" position="3" pipelineInput="false" globbing="false" required="false">
        <maml:name>Arguments</maml:name>
        <maml:description>
          <maml:para>Command line arguments (parameters) to be used when the shortcut is invoked.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="Desc" position="4" pipelineInput="false" globbing="false" required="false">
        <maml:name>Description</maml:name>
        <maml:description>
          <maml:para>The description is stored in the shortcut and displayed as a tooltip to users if they hover the mouse over the shortcut.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="WorkingDirectory,WorkingDir" position="5" pipelineInput="false" globbing="false" required="false">
        <maml:name>WorkDir</maml:name>
        <maml:description>
          <maml:para>The working directory for the program run when the end-user invokes the shortcut.</maml:para>
          <maml:para>When not specified, the new process will use the directory of the process executable as the working directory.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="6" pipelineInput="false" globbing="false" required="false">
        <maml:name>Icon</maml:name>
        <maml:description>
          <maml:para>Path to a file contiaining an icon.  In the case of PE formatted executable files with multiple icons embedded as resources, you can append a comma and resource icon index (i.e. "c:\path\foo.exe,2").</maml:para>
          <maml:para>When not specified the shortcut will have an icon extracted from the target, if possible.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="7" pipelineInput="false" globbing="false" required="false">
        <maml:name>WindowStyle</maml:name>
        <maml:description>
          <maml:para>Optional Window Style of resulting window when the end-user invokes the shortcut. </maml:para>
          <maml:para>Supported values: 1=Normal 3=Maximized 7=Minimized.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">Int</command:parameterValue>
        <dev:type>
          <maml:name>Int</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="8" pipelineInput="false" globbing="false" required="false">
        <maml:name>HotKey</maml:name>
        <maml:description>
          <maml:para>Optional hotkey to trigger the shortcut. </maml:para>
          <maml:para>Example: \"Ctrl+Alt+e\".</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="9" pipelineInput="false" globbing="false" required="false">
        <maml:name>CurrentUser</maml:name>
        <maml:description>
          <maml:para>Optional switch to indicate that the shortcut should be placed in the Current User profile and not for all users.</maml:para>
          <maml:para>By default, the shortcut is placed in the All Users Profile.</maml:para>
          <maml:para>If this swtich is given, it overrides that behavior, unless</maml:para>
          <maml:para>the ShortcutFolder parameter is specified. </maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="RunAsAdmin" position="10" pipelineInput="false" globbing="false" required="false">
        <maml:name>Admin</maml:name>
        <maml:description>
          <maml:para>Optional switch to indicate that the shortcut should have the RunAsAdministrator property set.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to New-PassiveStartMenuShortcut.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are target file or Icon file not found, and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Creates a shortcut in the all user's menu.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> New-PassiveStartMenuShortcut -Target "$($env:ProgramFiles)\Vendor\Product\file.exe" -Shortcut "Vendor\App" -Icon "$($env:ProgramFiles)\Vendor\Product\file.exe,2"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Creates the requested shortcut to the current user start menu.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

      <command:example>
        <maml:title>-------------- EXAMPLE 2 --------------</maml:title>
        <maml:introduction>
          <maml:para>Creates a shortcut in the Current User's Start menu.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> New-PassiveStartMenuShortcut -Target "$($env:ProgramFiles)\Vendor\Product\file.exe" -Shortcut "App1" -ShortcutFolder "Vendor1" -CurrentUser -Icon "$($env:ProgramFiles)\Vendor\Product\file.exe,2"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Creates the requested shortcut.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

      <command:example>
        <maml:title>-------------- EXAMPLE 3 --------------</maml:title>
        <maml:introduction>
          <maml:para>Creates a shortcut in the Specified location.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> New-PassiveStartMenuShortcut -Target "$($env:ProgramFiles)\Vendor\Product\file.exe" -Shortcut "App2.lnk" -ShortcutFolder "$($env:ALLUSERSPROFILE)\Microsoft\Windows\Start Menu\Programs\Vendor2" -Icon "$($env:ProgramFiles)\Vendor\Product\file.exe,2"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Creates the requested shortcut.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>


  <!-- Optimize Commands -->

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Optimize-PassiveNgenQueues</command:name>
      <maml:description>
        <maml:para>Flush all of the NGEN queues on the system.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Optimize</command:verb>
      <command:noun>PassiveNgenQueues</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Optimize-PassiveNgenQueues will locate and flush each of the NGEN optimization queues.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
      <maml:para></maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Optimize-PassiveNgenQueues</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="false">
          <maml:name>DoSilent</maml:name>
          <maml:description>
            <maml:para>Switch to hide the compilation window.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
          <maml:name>DoPassive</maml:name>
          <maml:description>
            <maml:para>Displays the NGEN output in a window.  This is the default setting.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="false">
        <maml:name>DoSilent</maml:name>
        <maml:description>
          <maml:para>Switch to hide the compilation window.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
        <maml:name>DoPassive</maml:name>
        <maml:description>
          <maml:para>TDisplays the NGEN output in a window.  This is the default setting.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Optimize-PassiveNgenQueues.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Ask NGEN to complete any DotNet optimization compilations. This is preferred as the last step of an installation/capture sequence.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Optimize-PassiveNgenQueues
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Causes NGEN to flush all queued up compilations. Will wait for this to complete.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Optimize-PassiveNgenCompileFile</command:name>
      <maml:description>
        <maml:para>Performs a native inteface compilation of the named file.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Optimize</command:verb>
      <command:noun>PassiveNgenCompileFile</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Optimize-PassiveNgenCompileFile will lattempt NGEN optimization on the named file.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
      <maml:para></maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Optimize-PassiveNgenCompileFile</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Is64Bit</maml:name>
          <maml:description>
            <maml:para>Boolean that determines if the 64-bit compilation is needed.</maml:para>         
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
          <maml:name>VersionString</maml:name>
          <maml:description>
            <maml:para>Either "v2.0.50727" for .net 2 through 3.5SP1 or "v4.0.30319" for 4.0 and above.</maml:para>         
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="2" pipelineInput="false" globbing="false" required="true">
          <maml:name>FileName</maml:name>
          <maml:description>
            <maml:para>Filename to be compiled.</maml:para>         
          </maml:description>
        </command:parameter>
         <command:parameter aliases="none" position="3" pipelineInput="false" globbing="false" required="false">
          <maml:name>DoSilent</maml:name>
          <maml:description>
            <maml:para>Switch to hide the compilation window.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="4" pipelineInput="false" globbing="false" required="false">
          <maml:name>DoPassive</maml:name>
          <maml:description>
            <maml:para>Displays the NGEN output in a window.  This is the default setting.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Ix64Bit</maml:name>
        <maml:description>
          <maml:para>Boolean indicating if the file is 64bit.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">Boolean</command:parameterValue>
        <dev:type>
          <maml:name>Boolean</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>false</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
        <maml:name>VersionString</maml:name>
        <maml:description>
          <maml:para>Either "v2.0.50727" for .net 2 through 3.5SP1 or "v4.0.30319" for 4.0 and above.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="2" pipelineInput="false" globbing="false" required="true">
        <maml:name>FileName</maml:name>
        <maml:description>
          <maml:para>Path to the exe or dll to be compiled..</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="3" pipelineInput="false" globbing="false" required="false">
        <maml:name>DoSilent</maml:name>
        <maml:description>
          <maml:para>Switch to hide the compilation window.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="4" pipelineInput="false" globbing="false" required="false">
        <maml:name>DoPassive</maml:name>
        <maml:description>
          <maml:para>Displays the NGEN output in a window.  This is the default setting.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Optimize-PassiveNgenCompileFile.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Ask NGEN to compile the given file immediately.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Optimize-PassiveNgenCompileFile  -Is64bit 1 -VersionString "v4.0.30319" -FileName "C:\Program Files\Vendor\Folder\File.net.exe"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Causes NGEN to compile the file. Will wait for this to complete.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>


  <!-- Redo commands -->
  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Redo-PassiveNewFirewallRules</command:name>
      <maml:description>
        <maml:para>Re-apply firewall rules that are new when comparing a before and after pair of Windows Firewall rules.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Redo</command:verb>
      <command:noun>PassiveNewFirewallRules</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Redo-PassiveNewFirewallRules will compare the two input structures previously returned from Get-PassiveFirewallRules and re-apply any rules present in the second list.</maml:para>
      <maml:para>The typical use is to run that command both before and after an application installation, and to pass the snapshots to the Redo-PassiveNewFirewallRules cmdlet.</maml:para>
      <maml:para>The Microsoft MSIX Packaging tool will not capture firewall rules added by the application installer.  It is a built in filter that we cannot configure.  By taking before and after snapshots, you can then ask the Redo cmdlet to re-write the registry entries so that they will be captured.</maml:para>
      <maml:para>NOTE: This cmdlet writes to HKLM and requires an elevated process.</maml:para>
      <maml:para>-WhatIf is not supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Redo-PassiveNewFirewallRules</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>InitialList</maml:name>
          <maml:description>
            <maml:para>PassiveInstall.Structures.FirewallRules structure from the pre-installation snapshot.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
          <maml:name>NewList</maml:name>
          <maml:description>
            <maml:para>PassiveInstall.Structures.FirewallRules structure from the post-installation snapshot.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>


    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>InitialList</maml:name>
        <maml:description>
          <maml:para>PassiveInstall.Structures.FirewallRules structure from the pre-installation snapshot.</maml:para>
          <maml:para>This is a list of the firewall rules, typically taken by Get-PassiceFirewallRules before the application installation.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">PassiveInstall.Structures.FirewallRules</command:parameterValue>
        <dev:type>
          <maml:name>PassiveInstall.Structures.FirewallRules</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
        <maml:name>NewList</maml:name>
        <maml:description>
          <maml:para>PassiveInstall.Structures.FirewallRules structure from the post-installation snapshot.</maml:para>
          <maml:para>This is a list of the firewall rules, typically taken by Get-PassiceFirewallRules after the application installation.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">PassiveInstall.Structures.FirewallRules</command:parameterValue>
        <dev:type>
          <maml:name>PassiveInstall.Structures.FirewallRules</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Redo-PassiveNewFirewallRules.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>PassiveInstall.Structures.FirewallRules</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>The rules that were updated.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>No errors should occur on a healthy system.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>This is a typical usage scenario:</maml:para>
        </maml:introduction>

        <dev:remarks>
          <maml:para></maml:para>
        </dev:remarks>
        
        <command:code/>
        <command:code>
PS> 
PS> $BeforeSnapshot = Get-PassiveFirewallRules
PS> msiexec /q vendorInstaller.msi
PS> $AfterSnapshot = Get-PassiveFirewallRules
PS> $Changes = Redo-PassiveNewFirewallRules $BeforeSnapshot $AfterSnapshot
PS> $Changes.Show()
PS>
        </command:code>

        <dev:remarks>
          <maml:para></maml:para>
          <maml:para>The scenario is an application installation for which we want any firewall rules added by the vendor installer to be properly captured by the MMPT.</maml:para>
          <maml:para>    1) Before the application installation a snapshot is saved.</maml:para>
          <maml:para>    2) The application installer is run.</maml:para>
          <maml:para>    3) After the application installation, a second snapshort is saved.</maml:para>
          <maml:para>    4) Then the Redo cmdlet is run to re-apply any new firewall rules added by the installer.</maml:para>
          <maml:para>    5) For giggles, the rules that were re-applied are displayed using the Show() method on the output object.</maml:para>
          <maml:para></maml:para>
          <maml:para>Only rules that are new in the after snapshot will be updated.</maml:para>
        </dev:remarks>
      </command:example>

    </command:examples>
  </command:command>



  <!-- Remove Commands -->
  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Remove-PassiveDesktopShortcuts</command:name>
      <maml:description>
        <maml:para>Removed the named shortcut(s) if on the desktop, either all user's or current user's.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Remove</command:verb>
      <command:noun>PassiveDesktopShortcuts</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Remove-PassiveDesktopShortcuts will remove the named shortcuts, without needing to know the path.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Remove-PassiveDesktopShortcuts</maml:name>
        <command:parameter aliases="Files" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Names</maml:name>
          <maml:description>
            <maml:para>The name of shortcut (or list of names of shortcuts), without the path.  The name may be either with or without the .LNK file extenion.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="Files" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Names</maml:name>
        <maml:description>
          <maml:para>The name of shortcut (or list of names of shortcuts), without the path.  The name may be either with or without the .LNK file extenion.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String[]</command:parameterValue>
        <dev:type>
          <maml:name>String[]</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Remove-PassiveDesktopShortcuts.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are insufficient permissions. A missing shortcut is logged, but not treated as an error.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Remove two shortcuts</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Remove-PassiveDesktopSHortcut -Names 'VendorApp', 'VendorHelp.lnk'
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Removes the requested shortcuts from All User's or Current User's desktop, if present.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Remove-PassiveEnvironmentVariables</command:name>
      <maml:description>
        <maml:para>Removed the named environment variables.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Remove</command:verb>
      <command:noun>PassiveEnvironmentVariables</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Remove-PassiveEnvironmentVariables will delete the named environment variables, if present.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Remove-PassiveEnvironmentVariables</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Names</maml:name>
          <maml:description>
            <maml:para>The name of variable (or list of names of variables).</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Names</maml:name>
        <maml:description>
          <maml:para>The name of variable (or list of names of variables).</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String[]</command:parameterValue>
        <dev:type>
          <maml:name>String[]</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Remove-PassiveEnvironmentVariables.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are insufficient permissions. A missing variable is logged, but not treated as an error.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Remove two variables</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Remove-PassiveEnvironmentVariables -Names 'ONEDRIVE', 'VendorStuff'
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Removes the requested environment variables, if present.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>
  
  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Remove-PassiveFiles</command:name>
      <maml:description>
        <maml:para>Removed the named Files.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Remove</command:verb>
      <command:noun>PassiveFiles</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Remove-PassiveFiles will delete the named Files, if present.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Remove-PassiveFiles</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Files</maml:name>
          <maml:description>
            <maml:para>The full path to a file (or list of paths to files).</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Files</maml:name>
        <maml:description>
          <maml:para>The full path to a File (or list of paths to Files).</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String[]</command:parameterValue>
        <dev:type>
          <maml:name>String[]</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Remove-PassiveFiles.</maml:para>
          </maml:description>
        </dev:type>
        <maml:description>
        </maml:description>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are file not found and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Remove two Files</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Remove-PassiveFiles -Folders '"C:\Program Files\Vendor\App\Cache\foo.txt", "C:\Program Files\Vendor\App\x64\bar.txt"'
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Removes the requested files, if present.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Remove-PassiveFolders</command:name>
      <maml:description>
        <maml:para>Removed the named Folders.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Remove</command:verb>
      <command:noun>PassiveFolders</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Remove-PassiveFolders will delete the named Folders, if present.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Remove-PassiveFolders</maml:name>
        <command:parameter aliases="Folder" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Folders</maml:name>
          <maml:description>
            <maml:para>The full path to a Folder (or list of paths to Folders).</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="Folder" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Folders</maml:name>
        <maml:description>
          <maml:para>The full path to a Folder (or list of paths to Folders).</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String[]</command:parameterValue>
        <dev:type>
          <maml:name>String[]</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Remove-PassiveFolders.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are folder not found and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Remove two Folders</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Remove-PassiveFolders -Folders '"C:\Program Files\Vendor\App\Cache", "C:\Program Files\Vendor\App\x64"'
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Removes the requested folders, if present.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>


  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Remove-PassiveInstallerCacheFilePattern</command:name>
      <maml:description>
        <maml:para>Look at the contents of the named folder and optionally for each subfolder, for filesnames matching a pattern, and remove it (optionally if it was created in the last 24 hours).</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Remove</command:verb>
      <command:noun>PassiveInstallerCacheFilePattern</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Remove-PassiveInstallerCacheFilePattern is used to remove newly created files located at or under the named folder.</maml:para>
      <maml:para>This is done because the names of these items might be randomized every time the installer is run, so we do not know them in advance.</maml:para>
      <maml:para>For example, many MSI installers will leave a installer cache folder using "SourceHash" followed by a randomly generated name.</maml:para>
      <maml:para>Or the MSI file itself might be a random number with a ".msi" extension.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Remove-PassiveInstallerCacheFilePattern</maml:name>
        <command:parameter aliases="Files" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Folder</maml:name>
          <maml:description>
            <maml:para>The name of the Folder to check.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="Pattern" position="1" pipelineInput="false" globbing="false" required="false">
          <maml:name>Pattern</maml:name>
          <maml:description>
            <maml:para>RegEx expression for matching the filename, defaults to "*".</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="2" pipelineInput="false" globbing="false" required="false">
          <maml:name>Recursive</maml:name>
          <maml:description>
            <maml:para>Option to also walk subdirectory trees.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="3" pipelineInput="false" globbing="false" required="false">
          <maml:name>IfToday</maml:name>
          <maml:description>
            <maml:para>Switch to first check if file was created within last 24 hours.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Folder</maml:name>
        <maml:description>
          <maml:para>The name of the Folder to check.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
        <maml:name>Patern</maml:name>
        <maml:description>
          <maml:para>RegEx string for pattern matching, defaults to "*".</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>*</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="2" pipelineInput="false" globbing="false" required="false">
        <maml:name>Recursive</maml:name>
        <maml:description>
          <maml:para>Switch requesting to also check subfolders recursively.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="false" required="false">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="9" pipelineInput="false" globbing="false" required="false">
        <maml:name>IfToday</maml:name>
        <maml:description>
          <maml:para>Switch requesting to skip deletion (without error) if folder was not created within the last 24 hours.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="false" required="false">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Remove-PassiveInstallerCacheFilePattern.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Remove the new windows installer sourcecache files for an application that caches into a randomly generated name.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Remove-PassiveInstallerCacheFilePattern -Folder 'C:\Windows\Installer' -Pattern "*SourceHash*" -IfToday
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Removes from the suggested folder that match the pattern.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

      <command:example>
        <maml:title>-------------- EXAMPLE 2 --------------</maml:title>
        <maml:introduction>
          <maml:para>Remove all newly created msi files directly under the Windows installer folder created in the last 24 hours.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Remove-PassiveInstallerCacheFilePattern -Folder "C:\Windows\Installer" -Pattern "*.msi" -IfToday
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Removes new msi files directly under the folder.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

         <command:example>
        <maml:title>-------------- EXAMPLE 3 --------------</maml:title>
        <maml:introduction>
          <maml:para>Remove all newly created matching files anywhere under the Windows installer folder created in the last 24 hours.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Remove-PassiveInstallerCacheFilePattern -Folder "C:\Windows\Installer" -Pattern "*.msi" -Recursive -IfToday
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Removes new msi files under the folder tree.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    
  </command:examples>
  </command:command>


  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Remove-PassiveInstallerCacheFolders</command:name>
      <maml:description>
        <maml:para>Delete the named folder, optionally checking first if empty and/or if it was created in the last 24 hours.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Remove</command:verb>
      <command:noun>PassiveInstallerCacheFolders</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Remove-PassiveInstallerCacheFolders is typically used to remove newly created subfolders or files located at the top level of the C:\Windows\Installer folder.</maml:para>
      <maml:para>This is done as part of a cleanup of the installer, however under no circumstances will not remove folders that have any contents.</maml:para>
      <maml:para>Generally, you remove the safe items under the folder and then attempt cleaning up the folder.  However there may be items you need to leave behind because
                 they are referenced by shortcuts or file associations.</maml:para>
      <maml:para>The two switch parameters, -IfEmpty and -IfToday, are used to have the cmdlet first check conditions on the folder and to passivly skip deletion if conditions are not met.</maml:para>
      <maml:para>This cmdlet may be used on other folders, there is no logic specific to the Windows Installer cache.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Remove-PassiveInstallerCacheFolders</maml:name>
        <command:parameter aliases="Folder" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Folders</maml:name>
          <maml:description>
            <maml:para>The name of the Folder, or list of Folders, to delete.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
          <maml:name>IfEmpty</maml:name>
          <maml:description>
            <maml:para>Switch to first check if folder is empty rather than generate an error.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="2" pipelineInput="false" globbing="false" required="false">
          <maml:name>IfToday</maml:name>
          <maml:description>
            <maml:para>Switch to first check if the folder was created within the last 24 hours.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="Files" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Folder</maml:name>
        <maml:description>
          <maml:para>The name of the Folder or Folders to check.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
        <maml:name>IfEmpty</maml:name>
        <maml:description>
          <maml:para>Switch requesting to skip deletion (without error) if folder is not empty.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="false" required="false">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="2" pipelineInput="false" globbing="false" required="false">
        <maml:name>IfToday</maml:name>
        <maml:description>
          <maml:para>Switch requesting to skip deletion (without error) if folder was not created within the last 24 hours.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="false" required="false">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Remove-PassiveInstallerCacheFolders.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure.</maml:name>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are insufficient permissions, or non-empty folder without the -IfEmpty switch.  A missing of skipped folder is logged, but not treated as an error.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Remove the named folder, but only if it is empty and created today.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Remove-PassiveInstallerCacheFolders -Folder "C:\Windows\Installer\{4DD78A4D-6BED-4FA4-8860-25C7EFCD84BA}" -IfEmpty -IfToday
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Checks that the folder exists, is empty, and created today; if so the folder is deleted.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
  </command:examples>
  </command:command>
  
  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Remove-PassiveRegistryItem</command:name>
      <maml:description>
        <maml:para>Removed the named Registry Key or Item.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Remove</command:verb>
      <command:noun>PassiveRegistryItem</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Remove-PassiveRegistryItem will delete the registry item or key (including subtrees), if present.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Remove-PassiveRegistryItem</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Hive</maml:name>
          <maml:description>
            <maml:para>Hive to use, such as HKLM or HKCU, or HKEY_LOCAL_MACHINE format also.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
          <maml:name>Item</maml:name>
          <maml:description>
            <maml:para>The path to a Registry key or item, in the form "Software\...".</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Hive</maml:name>
        <maml:description>
          <maml:para>The Registry Hive to use, such as HKLM or HKEY_CURRENT_USER format.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="true">
        <maml:name>Item</maml:name>
        <maml:description>
          <maml:para>The path to a Registry key or item, in the form "Software\...".</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Remove-PassiveRegistryItem.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are item not found and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Remove a key and anything underneath it.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Remove-PassiveRegistryItem -Hive "HKEY_LOCAL_MACHINE" -Item "Software\Policies\Vendor"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Removes the registry key, and all children, if present.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

      <command:example>
        <maml:title>-------------- EXAMPLE 2 --------------</maml:title>
        <maml:introduction>
          <maml:para>Remove a registry item.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Remove-PassiveRegistryItem -HIVE "HKLM" -Item "Software\Vendor\ValueName"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Removes the registry item, if present.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

  </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Remove-PassiveStartMenuShortcuts</command:name>
      <maml:description>
        <maml:para>Removed the named shortcut(s) if on the start menu, either all user's or current user's.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Remove</command:verb>
      <command:noun>PassiveStartMenuShortcuts</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Remove-PassiveStartMenuShortcuts will remove the named shortcuts, without needing to know the path.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Remove-PassiveStartMenuShortcuts</maml:name>
        <command:parameter aliases="Files" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Names</maml:name>
          <maml:description>
            <maml:para>The name of shortcut (or list of names of shortcuts), without the path.  The name may be either with or without the .LNK file extenion.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="Files" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Names</maml:name>
        <maml:description>
          <maml:para>The name of shortcut (or list of names of shortcuts), without the path.  The name may be either with or without the .LNK file extenion.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String[]</command:parameterValue>
        <dev:type>
          <maml:name>String[]</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Remove-PassiveStartMenuShortcuts.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are insufficient permissions. A missing shortcut is logged, but not treated as an error.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Remove two shortcuts</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Remove-PassiveStartMenuShortcuts -HIVE "HKLM" -Item "Software\Vendor\ValueNameRemove-PassiveStartMenuShortcuts -Names 'VendorApp', 'VendorHelp.lnk'
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Removes the requested shortcuts from All User's or Current User's desktop, if present.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  
  <!-- Set Commands-->
  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Set-PassiveServiceAccount</command:name>
      <maml:description>
        <maml:para>Sets each listed windows service to use the requested account name for the logon account.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Set</command:verb>
      <command:noun>PassiveServiceAccount</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Set-PassiveServiceAccount will set the logon account of the requested Windows Services to requested account.  It does not stop/restart the running service(s).</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Set-PassiveServiceAccount</maml:name>

        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Name</maml:name>
          <maml:description>
            <maml:para>The Name (not display name) of the service.</maml:para>
          </maml:description>
        </command:parameter>

        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
          <maml:name>Account</maml:name>
          <maml:description>
            <maml:para>The name of the logon account for the service (eg: "LocalSystem").</maml:para>
          </maml:description>
        </command:parameter>

      </command:syntaxItem>
    </command:syntax>
    <command:parameters>

      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Name</maml:name>
        <maml:description>
          <maml:para>The name (not Display Name) of the installed Windows Service.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>

      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
        <maml:name>Account</maml:name>
        <maml:description>
          <maml:para>The new logon account for the windows service (eg: "LocalSystem").</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>LocalSystem</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Set-PassiveServiceAccount.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are service not found and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Changes a service to use the local system account</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Set-PassiveServiceAccount -Name 'CrummyVendorUpdaterService' -Account "LocalSystem"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Use the 'Service Name' and not the 'Display Name' when naming a service.</maml:para>
          <maml:para>If the service is currently running, this cmdlet will not automatically stop/restart it, but it will be updated.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>


      <command:example>
        <maml:title>-------------- EXAMPLE 2 --------------</maml:title>
        <maml:introduction>
          <maml:para>Sets a service to use a different account.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Set-PassiveServiceAccount -Name "CrummyVendorUpdaterService" -Account "NT Authority\LocalService"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Use the 'Service Name' and not the 'Display Name' when naming a service.</maml:para>
          <maml:para>If the service is currently running, this cmdlet will not automatically stop/restart it, but it will be updated.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

    </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Set-PassiveShortcutFixupBatCmd</command:name>
      <maml:description>
        <maml:para>Updates the form of a shortcut to not link directly to a bat or cmd file.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Set</command:verb>
      <command:noun>PassiveShortcutFixupBatCmd</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Set-PassiveShortcutFixupBatCmd will fix an issue with shortcuts that occurs with App-V 5.</maml:para>
      <maml:para>Shortcuts that simply link to a file ending in .Bat or .Cmd fail to work correctly under App-V 5.x.</maml:para>
      <maml:para>This fixup re-writes the shortcut to use C:\Windows\System32\cmd.exe.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Set-PassiveShortcutFixupBatCmd</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Shortcut</maml:name>
          <maml:description>
            <maml:para>The full path to the shortcut.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Shortcut</maml:name>
        <maml:description>
          <maml:para>The full name to the shortcut.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Set-PassiveShortcutFixupBatCmd.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are shortcut file not found, and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Update a shortcut</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Set-PassiveShortcutFixupBatCmd -Shortcut "C:\ProgramData\Microsoft\Start Menu\Vendor\Something.lnk"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Updates the requested shortcut.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Set-PassiveShortcutFixupReg</command:name>
      <maml:description>
        <maml:para>Updates the form of a shortcut to not link directly to a reg file.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Set</command:verb>
      <command:noun>PassiveShortcutFixupReg</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Set-PassiveShortcutFixupReg will fix an issue with shortcuts that occurs with App-V 5.</maml:para>
      <maml:para>Shortcuts that simply link to a file ending in .Reg fail to work correctly under App-V 5.x.</maml:para>
      <maml:para>This fixup re-writes the shortcut to use C:\Windows\System32\reg.exe.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Set-PassiveShortcutFixupReg</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Shortcut</maml:name>
          <maml:description>
            <maml:para>The full path to the shortcut.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Shortcut</maml:name>
        <maml:description>
          <maml:para>The full name to the shortcut.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Set-PassiveShortcutFixupReg.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are shortcut file not found, and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Update a shortcut</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Set-PassiveShortcutFixupReg -Shortcut "C:\ProgramData\Microsoft\Start Menu\Vendor\Something.lnk"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Updates the requested shortcut.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Set-PassiveShortcutFixupSpaceAtEnd</command:name>
      <maml:description>
        <maml:para>Updates the form of a shortcut to not link have a space at the end of the filename.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Set</command:verb>
      <command:noun>PassiveShortcutFixupSpaceAtEnd</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Set-PassiveShortcutFixupSpaceAtEnd will fix an issue with shortcuts that occurs with App-V 5.</maml:para>
      <maml:para>Shortcuts that end in a space fail to work correctly under App-V 5.x.</maml:para>
      <maml:para>This fixup re-names the shortcut.</maml:para>
      <maml:para>WhatIf and Confirm are supported.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Set-PassiveShortcutFixupSpaceAtEnd</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Shortcut</maml:name>
          <maml:description>
            <maml:para>The full path to the shortcut.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Shortcut</maml:name>
        <maml:description>
          <maml:para>The full name to the shortcut.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Set-PassiveShortcutFixupSpaceAtEnd.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are shortcut file not found, and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Update a shortcut</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Set-PassiveShortcutFixupSpaceAtEnd -Shortcut "C:\ProgramData\Microsoft\Start Menu\Vendor\Something .lnk"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Updates the requested shortcut filename.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Set-PassiveWindowsServiceAccount</command:name>
      <maml:description>
        <maml:para>Sets each listed windows service to use the requested account name for the logon account.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Set</command:verb>
      <command:noun>PassiveWindowsServiceAccount</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Set-PassiveServiceAccount will set the logon account of the requested Windows Services to requested account.  It does not stop/restart the running service(s).</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Set-PassiveServiceAccount</maml:name>

        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
          <maml:name>Name</maml:name>
          <maml:description>
            <maml:para>The Name (not display name) of the service.</maml:para>
          </maml:description>
        </command:parameter>

        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
          <maml:name>Account</maml:name>
          <maml:description>
            <maml:para>The name of the logon account for the service (eg: "LocalSystem").</maml:para>
          </maml:description>
        </command:parameter>

      </command:syntaxItem>
    </command:syntax>
    <command:parameters>

      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="true">
        <maml:name>Name</maml:name>
        <maml:description>
          <maml:para>The name (not Display Name) of the installed Windows Service.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>

      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
        <maml:name>Account</maml:name>
        <maml:description>
          <maml:para>The new logon account for the windows service (eg: "LocalSystem").</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>LocalSystem</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Set-PassiveServiceAccount.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The most common errors are service not found and insufficient permissions.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Changes a service to use the local system account</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Set-PassiveServiceAccount -Name 'CrummyVendorNetworkService' -Account "LocalSystem"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Use the 'Service Name' and not the 'Display Name' when naming a service.</maml:para>
          <maml:para>If the service is currently running, this cmdlet will not automatically stop/restart it, but it will be updated.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>


      <command:example>
        <maml:title>-------------- EXAMPLE 2 --------------</maml:title>
        <maml:introduction>
          <maml:para>Sets a service to use a different account.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Set-PassiveServiceAccount -Name "CrummyVendorUpdateNetworkService" -Account "NT Authority\LocalService"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Use the 'Service Name' and not the 'Display Name' when naming a service.</maml:para>
          <maml:para>If the service is currently running, this cmdlet will not automatically stop/restart it, but it will be updated.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

    </command:examples>
  </command:command>
  
  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Set-PassiveWinColors</command:name>
      <maml:description>
        <maml:para>Updates colors used in the current powershell window, optionally clearing the screen.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Set</command:verb>
      <command:noun>PassiveWinColors</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Set-PassiveWinColors will change the color scheme in the PowerShell window.</maml:para>
      <maml:para>This might be used, for example, to color the window differently while installing dependencies than when performing main installs.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Set-PassiveWinColors</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="false">
          <maml:name>Background</maml:name>
          <maml:description>
            <maml:para>The color for the PowerShell window background.</maml:para>
            <maml:para>Only the 16 standard system colors are supported:</maml:para>
            <maml:para>     Black</maml:para>
            <maml:para>     Blue</maml:para>
            <maml:para>     Cyan</maml:para>
            <maml:para>     DarkBlue</maml:para>
            <maml:para>     DarkCyan</maml:para>
            <maml:para>     DarkGray</maml:para>
            <maml:para>     DarkGreen</maml:para>
            <maml:para>     DarkMagenta</maml:para>
            <maml:para>     DarkRed</maml:para>
            <maml:para>     DarkYellow</maml:para>
            <maml:para>     Gray</maml:para>
            <maml:para>     Green</maml:para>
            <maml:para>     Magenta</maml:para>
            <maml:para>     Red</maml:para>
            <maml:para>     Yellow</maml:para>
            <maml:para>     White</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
          <maml:name>Foreground</maml:name>
          <maml:description>
            <maml:para>The color for the PowerShell window foreground.</maml:para>
            <maml:para>Only the 16 standard system colors are supported:</maml:para>
            <maml:para>     Black</maml:para>
            <maml:para>     Blue</maml:para>
            <maml:para>     Cyan</maml:para>
            <maml:para>     DarkBlue</maml:para>
            <maml:para>     DarkCyan</maml:para>
            <maml:para>     DarkGray</maml:para>
            <maml:para>     DarkGreen</maml:para>
            <maml:para>     DarkMagenta</maml:para>
            <maml:para>     DarkRed</maml:para>
            <maml:para>     DarkYellow</maml:para>
            <maml:para>     Gray</maml:para>
            <maml:para>     Green</maml:para>
            <maml:para>     Magenta</maml:para>
            <maml:para>     Red</maml:para>
            <maml:para>     Yellow</maml:para>
            <maml:para>     White</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="2" pipelineInput="false" globbing="false" required="false">
          <maml:name>Clear</maml:name>
          <maml:description>
            The optional switch causes the powershell console screen to be cleared.  This is useful when
            used at the beginning of a script (before useful contents appear) and you are changing the
            background color.
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="false">
        <maml:name>Background</maml:name>
        <maml:description>
          <maml:para>The color for background.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
        <maml:name>Foreground</maml:name>
        <maml:description>
          <maml:para>The color for foreground.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="2"  pipelineInput="false" globbing="false" required="false">
        <maml:name>Clear</maml:name>
        <maml:description>
          The optional switch causes the powershell console screen to be cleared.  This is useful when
          used at the beginning of a script (before useful contents appear) and you are changing the
          background color.
        </maml:description>
        <command:parameterValue variableLength="false" required="false">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Set-PassiveWinColors.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The worst that can happen is that you set foreground to match background and you can't read a thing.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Change Background only and clears the window so as to set the entire background.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Set-PassiveWinColors -Background 'Gray' -Clear
PS>
        </command:code>
        <dev:remarks>
          <maml:para>
            If you change the window background without clearing, only the cells where future text is displayed gets the
            new background color, which looks awfull. But clear will also clear out any existing text that is in the buffer,
            so the Clear switch is mostly useful at the beginning of a powershell script.
          </maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

      <command:example>
        <maml:title>-------------- EXAMPLE 2 --------------</maml:title>
        <maml:introduction>
          <maml:para>Change the default foreground text color and Background and clears the window so as to set the entire background.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Set-PassiveWinColors -Foreground 'Black' -Background 'Gray' -Clear
PS>
        </command:code>
        <dev:remarks>
          <maml:para>
            Changing the foreground color only sets the default text color for future output; if future cmdlets output colored
            text it still will be colored as they requested.
          </maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

    </command:examples>
  </command:command>

  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Set-PassiveWinSize</command:name>
      <maml:description>
        <maml:para>Updates size/position used in the current powershell window.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Set</command:verb>
      <command:noun>PassiveWinSize</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>Set-PassiveWinSize will change the width, height, position, and/or title, of the PowerShell window, or hides it altogether.</maml:para>
      <maml:para>This might be used, for example, to help in monitoring automated installations.</maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Set-PassiveWinSize</maml:name>
        <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="false">
          <maml:name>Width</maml:name>
          <maml:description>
            <maml:para>The width, in characters, for the PowerShell window.</maml:para>
            <maml:para>If size requested is greater than the buffer size the buffer wize will also be updated.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
          <maml:name>Height</maml:name>
          <maml:description>
            <maml:para>The height, in characters, for the PowerShell window.</maml:para>
            <maml:para>If size requested is greater than the buffer size the buffer wize will also be updated.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="X" position="2" pipelineInput="false" globbing="false" required="false">
          <maml:name>PositionX</maml:name>
          <maml:description>
            <maml:para>The x position, in pixels, for the PowerShell window.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="Y" position="3" pipelineInput="false" globbing="false" required="false">
          <maml:name>PositionY</maml:name>
          <maml:description>
            <maml:para>The Y position, in pixels, for the PowerShell window.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="Y" position="4" pipelineInput="false" globbing="false" required="false">
          <maml:name>Title</maml:name>
          <maml:description>
            <maml:para>The Title for the PowerShell window.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="5" pipelineInput="false" globbing="false" required="false">
          <maml:name>DoSilent</maml:name>
          <maml:description>
            The optional switch hides the window.
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="none" position="0" pipelineInput="false" globbing="false" required="false">
        <maml:name>Width</maml:name>
        <maml:description>
          <maml:para>The width, in characters, for the PowerShell window.</maml:para>
          <maml:para>If size requested is greater than the buffer size the buffer wize will also be updated.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">Int</command:parameterValue>
        <dev:type>
          <maml:name>Int</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
        <maml:name>Height</maml:name>
        <maml:description>
          <maml:para>The height, in characters, for the PowerShell window.</maml:para>
          <maml:para>If size requested is greater than the buffer size the buffer wize will also be updated.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">Int</command:parameterValue>
        <dev:type>
          <maml:name>Int</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="X" position="2" pipelineInput="false" globbing="false" required="false">
        <maml:name>PositionX</maml:name>
        <maml:description>
          <maml:para>The X position, in pixels, for the PowerShell window relative to the user desktop.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">Int</command:parameterValue>
        <dev:type>
          <maml:name>Int</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="Y" position="3" pipelineInput="false" globbing="false" required="false">
        <maml:name>PositionY</maml:name>
        <maml:description>
          <maml:para>The Y position, in pixels, for the PowerShell window relative to the user desktop.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">Int</command:parameterValue>
        <dev:type>
          <maml:name>Int</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="4" pipelineInput="false" globbing="false" required="false">
        <maml:name>Height</maml:name>
        <maml:description>
          <maml:para>The title for the PowerShell window.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
      <command:parameter aliases="none" position="5"  pipelineInput="false" globbing="false" required="false">
        <maml:name>DoSilent</maml:name>
        <maml:description>
          The optional switch hides the window.
        </maml:description>
        <command:parameterValue variableLength="false" required="false">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>
    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Set-PassiveWinSize.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Text indicating success or failure</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>The worst that can happen is that you set sizes smaller than powershell allows.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Change size, position, and title.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Set-PassiveWinSize -Height 44 -Width 120 -X 5 -Y 5 -Title "Primary PassiveInstall for 7-Zip"
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Updates the window size, loacation, and sets the window title.</maml:para>
        </dev:remarks>
      </command:example>

      <command:example>
        <maml:title>-------------- EXAMPLE 2 --------------</maml:title>
        <maml:introduction>
          <maml:para>Hide the window.</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Set-PassiveWinSize -DoSilent
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Hides the window by minimizing it.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>

      <command:example>
        <maml:title>-------------- EXAMPLE 3 --------------</maml:title>
        <maml:introduction>
          <maml:para>Application install wrapper script.</maml:para>
        </maml:introduction>

        <command:code/>
        <command:code>
PS>
if ($DoSilent -eq 1)
{
    Set-PassiveWinSize 10 7 5 5 -Title "PowerShell - $($AppName)" -DoSilent
    # Ensure we are running elevated
    Approve-PassiveElevation -AsAdmin
}
else
{
    Set-PassiveWinSize 80 40 5 5 -Title "PowerShell - $($AppName)"
    Set-PassiveWinColors  -Background 'DarkGray' -Foreground 'White'

    # Ensure we are running elevated
    Approve-PassiveElevation -AsAdmin

    Set-PassiveWinSize  100 44 10 10 -Title "[Elevated] PowerShell - $($AppName)"
    Set-PassiveWinColors  -Background 'DarkGray' -Foreground 'White'

    Write-host 'Starting - PassiveInstall.ps1'
}
PS>
        </command:code>
        <dev:remarks>
          <maml:para>We often use this in our automated packaging scripts.</maml:para>
          <maml:para>The $DoSilent variable allows the same script to work silently for Intune installs and passively for our packaging efforts where we are not worried about someone interfering with the install but like to see the progress happening.</maml:para>
          <maml:para>In the passive case, the unelevated launcher window is smaller and gray, while the elevated window doing the work is larger.</maml:para>
          <maml:para>Most of the cmdlets in this module have a -DoSilent option you can use as well.</maml:para>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

  <!-- Show commands -->
  <command:command xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:maml="http://schemas.microsoft.com/maml/2004/10">

    <command:details>
      <command:name>Show-PassiveTimer</command:name>
      <maml:description>
        <maml:para>Runs a visual timer for a given time with optional message.</maml:para>
      </maml:description>
      <maml:copyright>
        <maml:para>Copyright 2026, TMurgent Technologies, LLP</maml:para>
      </maml:copyright>
      <command:verb>Show</command:verb>
      <command:noun>PassiveTimer</command:noun>
      <dev:version/>
    </command:details>

    <maml:description>
      <maml:para>
        Show-PassiveTimer will show a visual progress for the specified time in ms.
      </maml:para>
      <maml:para>
       Think of this as a sleep with a progress bar. A progress bar is visually displayed and updated every 200ms until completion. 
       You can specify an optional message for the display.
      </maml:para>
      <maml:para>
        The user can pause the timer by selecting text anywhere in the PowerShell window, or hitting the P button on the keyboard.
        When paused, hitting the Q button will quite this sleep, while hitting any other key will resume the rest of the sleep.
      </maml:para>
      <maml:para>
        The cmdlet uses a progress bar to show progress against the requested time.  
        This progress bar is shown near the top of the PowerShell window, similar to other PS progress bars you've seen in the past.
        I recommend outputting a few blank lines (Write-Console "") at the top of your script so that this bar doesn't hide the important output messages that the user wants to review.
      </maml:para>
    </maml:description>

    <command:syntax>
      <command:syntaxItem>
        <maml:name>Show-PassiveTimer</maml:name>
        <command:parameter aliases="Length" position="0" pipelineInput="false" globbing="false" required="false">
          <maml:name>LengthMS</maml:name>
          <maml:description>
            <maml:para>Total time in miliseconds for the timer.</maml:para>
          </maml:description>
        </command:parameter>
        <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false"  required="false">
          <maml:name>Message</maml:name>
          <maml:description>
            <maml:para>A descriptive message to display.</maml:para>
          </maml:description>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>

    <command:parameters>
      <command:parameter aliases="Length" position="0" pipelineInput="false" globbing="false" required="false">
        <maml:name>LengthMS</maml:name>
        <maml:description>
          <maml:para>Total time in miliseconds for the timer.</maml:para>
          <maml:para>Progress is visual updated every 200ms.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">Int</command:parameterValue>
        <dev:type>
          <maml:name>Int</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>1000</dev:defaultValue>
      </command:parameter>

      <command:parameter aliases="none" position="1" pipelineInput="false" globbing="false" required="false">
        <maml:name>Message</maml:name>
        <maml:description>
          <maml:para>An optional message to display with the timer.</maml:para>
        </maml:description>
        <command:parameterValue variableLength="true" required="true">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri/>
        </dev:type>
        <dev:defaultValue>none</dev:defaultValue>
      </command:parameter>

    </command:parameters>

    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para>You cannot pipe objects to Show-PassiveTimer.</maml:para>
          </maml:description>
        </dev:type>
      </command:inputType>
    </command:inputTypes>

    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>None.</maml:name>
          <maml:uri> </maml:uri>
          <maml:description>
            <maml:para/>
          </maml:description>
        </dev:type>
        <maml:description>
          <maml:para>Text strings are output suitable for logging.</maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>

    <command:terminatingErrors>
      <maml:description>
        <maml:para>None.</maml:para>
      </maml:description>
    </command:terminatingErrors>
    <command:nonTerminatingErrors/>

    <command:examples>

      <command:example>
        <maml:title>-------------- EXAMPLE 1 --------------</maml:title>
        <maml:introduction>
          <maml:para>Start a timer with a message</maml:para>
        </maml:introduction>
        
        <command:code/>
        <command:code>
PS>
PS> Show-PassiveTimer -LengthMS 10000 -Message 'Delay timer before end of script. Ctrl-C to terminate early.'
PS>
        </command:code>
        <dev:remarks>
          <maml:para>Typical use at the end of a PowerShell script, allowing the user to review output of previous commands or ending the script at will.</maml:para>
          <maml:para/>
        </dev:remarks>
      </command:example>
    </command:examples>
  </command:command>

</helpItems>