Documentation

Contents
Contents
Contents
Contents

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 3 or above
  • Administrative permissions
    • Needed to collect process owners of all running uberAgent processes
  • The script execution policy must be set to either RemoteSigned or Unrestricted. Check the script execution policy setting by executing Get-ExecutionPolicy. If the policy is not set to one of the two required values, run PowerShell as an administrator and execute Set-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/li>

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