Creating an uberAgent Support Bundle
It may happen that the uberAgent support team asks you to create an uberAgent support bundle. A support bundle is a collection of log files and registry items which helps the support team troubleshoot your case. A PowerShell module is available which does the work for you. Learn below how to use it.
Requirements
- At least Windows 7 or Windows Server 2008 R2
- PowerShell version 5 or above
- Administrative permissions
- Needed to collect process owners of all running uberAgent processes
- The script execution policy must be set to either
RemoteSigned
orUnrestricted
. Check the script execution policy setting by executingGet-ExecutionPolicy
. If the policy is not set to one of the two required values, run PowerShell as an administrator and executeSet-ExecutionPolicy RemoteSigned -Scope CurrentUser -Confirm
Installation
Installing via PowerShellGet
The uberAgent support module is available on the PowerShell Gallery and can be installed using the PowerShellGet module.
- Open PowerShell and run
Install-Module uberAgentSupport
- If you see an error like “The term ‘Install-Module’ is not recognized as the name…” install PowerShellGet or update to at least PowerShell version 5.0.
- To update to the latest module version use
Update-Module uberAgentSupport
Installing manually
- Download the module from GitHub as a zip file and unzip it somewhere
- Run
Import-Module path-to-module\uberAgentSupport.psd1
- To update to the latest module version use
Import-Module path-to-module\uberAgentSupport.psd1 -Force
when importing
Usage
Open an elevated PowerShell and run New-uASupportBundle
. No parameters required. A zip file will be placed on your desktop.
Deinstallation
To completely remove the module from your system run
$Module = Get-Module uberAgentSupport
Remove-Module $Module.Name
Remove-Item $Module.ModuleBase -Recurse -Force