Documentation

Contents
Contents
Contents
Contents
!
This documentation applies to a beta version of uberAgent (docs for the latest official release)

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

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

Leave a Reply

Your email address will not be published. Required fields are marked *