COMMANDS 1 Overview... 1 Default Commands... 2 Creating a Script from a Command Document Revision History... 10

Transcription

1 LabTech Commands COMMANDS 1 Overview... 1 Default Commands... 2 Creating a Script from a Command Document Revision History Overview Commands in the LabTech Control Center send specific instructions to agent computers such as resending database inventory information or shutting down a computer. Depending on the type of instruction, you can send this to a client, location, group or to a specific agent. When a command is sent to a LabTech agent, the command is stored in the database until the agent checks in. This is typically five minutes unless the machine is in FasTalk mode. This document outlines the commands that can be accessed from the Commands menu. Additional commands are available to send directly to an agent from the Remote Commands tab (Dashboard > Management > Remote Commands). For more information, please refer to the Remote Commands documentation. Additionally, you can create your own custom commands to be added to the Commands menu structure. For more information, please refer to the Custom Commands documentation. NOTE: You must belong to a user class with full client permissions and have Send Command access specific to the client or group. Please refer to the Permissions documentation for additional information on user permissions, if necessary. There are two methods of sending commands but some commands may only be available from the Computer Management screen: 1. From the navigation tree, right-click a group, client, location or computer. 2. Select Commands. 3. Select the desired command category and then select the desired command. -Or- 1. Double-click on the agent computer on the navigation tree to open the Computer Management screen 2. Click Begin. 3. Select Commands. 4. Select the desired command category and then select the desired command. NOTE: Commands attempt to run concurrently, each as its own process. There is no hierarchy of commands and they are not run sequentially when input. You can view the status of a command by double-clicking on an agent to open the Computer Management screen and then selected the Commands tab or by looking at the Console in the Control Center Commands 1

2 Commands Default Commands Name Inventory Resend Everything Resend Events Resend Hardware Table 1: LabTech Agent Commands Description The agent will send events, hardware, printer, processes, hotfixes, services, startup list, disk info, software, system info, and network information. This information is used to update the database. The agent will send all of the Inventory commands: Events Hardware Printers Processes Hotfixes Services Startup List Disk Info Software System Info Network Info Update Config If you request to send everything, the server will send each of the inventory commands separately. The agent will send log information about: Windows updates Application System Security Event Logs Plus any additional event log channels you have subscribed to on Vista or higher machines. Log tab of the Computer Management screen. The agent will send hardware information: Processors Memory Open Ports Network Cards Chassis & Bios information. database and the Hardware and Devices tabs in the Computer Management screen Commands 2

3 LabTech Resend Printers Resend Processes Resend Hotfixes Resend Services The agent will send printer information: Installed Printers Printer Names Port Names Resolution Paper Types database and the Printer tab in the Computer Management screen. The agent will send information on the current processes. CPU usage Name of process Process ID Scheduled tasks Memory usage Priority Creation date Number of computers with that process. Information on the Process Process tab in the Computer Management screen. Note: If the process filter is enabled then the agent machine will not update the process. The agent will update hotfix Information based on the agent s Windows Update information. Hotfix category Hotfix severity If the hotfix is installed If the hotfix was pushed to the machine If the hotfix was approved Hotfix title Patching tab of the Computer Management screen and the Patch Manager. The agent will send current service information: Names Descriptions Status Startup Service Type Service Account File Path Services tab in the Computer Management screen Commands 3

4 Commands Resend Startup List Resend Disk Info Resend Software Resend System Info The agent will perform a startup scan with the currently loaded definitions and registry values updating the following startup information. Startup definition Name Value File name Startup tab in the Computer Management screen. The agent will update current disk information: Drive ID and Letter Drive Size Total Fragmentation percentage File System Drive Model Volume Size If the drive is a solid-state drive. The solid state information may not be 100% accurate due to the lack of industry standards. Drives tab of the Computer Management screen. The agent will send the current software information: Name Install Location Installed Date Initial Size Version App Listing (if application has been whitelisted or blacklisted) Software tab in the Computer Management screen. The agent will send information on: If ShadowProtect is installed Results of virus scanner check Last time Windows Updated file (windowsupdate.log) was updated Computer uptime Power status Count of files in temp directory Current power settings Windows score setting (for Windows Vista and higher) o CPU score o D3D score o Disk score o Graphics score o Memory score Trackers Hardware information Time zone Welcome, Info, LTBackup, and Devices tabs in the Computer Management screen Commands 4

5 LabTech Resend Network Info Update Config System Tools Open File Explorer Open Registry Editor Set Windows Update Defaults Set Windows Update Settings Disable User Access to Windows Update Enable User Access to Windows Update Force Windows Update to Run Set WSUS Server Address Set Windows Update to download only. The agent will send information on: Open ports NIC cards DNS Shared drives Port usage Files in TFTP directory (only if the probe is installed) Network tab in the Computer Management screen. Instructs the agent to download the most current agent template, virus definitions, startup definitions, schedule and probe information (any information that is required to push the agent). Other probe information, such as domain passwords, auto push settings, etc. are handled by the Probe > Refresh Configuration command. Opens a File Explorer on the agent to perform various functions on the remote agent. Refer to the File Explorer documentation for more information. This does not have an Undo command, use with caution. Opens the Registry Editor similar to the Windows Registry Editor to edit strings, create new key, delete, create monitors, etc. This does not have an Undo command, use with caution. Set the Windows Update agent to run from the default settings. Disables the ability for the agent machine to install Windows updates. The user of the agent machine will no longer be prompted to install Windows updates. Enables the ability for the agent machine to install Windows updates. The user of the agent machine will be prompted to install Windows updates. (The agent machines users will be prompted to install windows updates.) Sends a command to the Windows update agent to check for new updates. Opens a window to enter the FQDN of a WSUS Windows Update server to deploy patches. For more information, refer to the WSUS Server documentation. Sets Windows updates to download only, not to install Commands 5

6 Commands Set Windows Update for LabTech only Disable Windows Update Install the Windows Update agent Sets Windows update to only install patches that are approved and pending in the Patch Manager and Patching tab. Disables the Microsoft Windows Update agent. Updates the Windows Update agent with the latest version of the Window Update agent. Reattempt Failed Patches Approve all Patches Deploy patches Deploy all Security Patches Deploy all Approved Patches Deploy all Patches Reattempts to install all patches that have failed to install. Approves all Windows update patches. Deploys all Windows security patches. Deploys all patches that have been approved in the Patch Manager or Hotfix tab. Deploys all patches, even those that are not approved by the Patch Manager or Hotfix tab. Schedule Task Full System Virus Scan Update Virus Defs File Download File From LTShare Download File From an Address Find a File Disk CleanUp Open File Explorer User Desktop Uses the Windows Task Scheduler to schedule a task on the machine. It s the same as doing an at command to schedule tasks on a machine. Performs a full scan of the agent system. This will only work if a compatible antivirus program is installed on the remote machine. Updates the definitions of the agent machine s antivirus program. This will only work if a compatible antivirus program is installed on the remote machine. Downloads a file to the agent machine from the LTShare. If the destination is not a full path then the path is assumed to be in the %Temp% folder. Downloads a file from an IP address or URL to the selected agent machine. Searches the selected computer for a file. The system will return the location of that file on the Console of the Control Center. Runs the Disk Cleanup process to remove temp files, downloaded files, empty recycle bin, etc. To modify where these files are removed from, open the Disk Cleanup tab in the Dashboard (Dashboard > Config > Configurations > Disk Cleanup). Opens the LabTech File Explorer for the selected agent machine Commands 6

7 LabTech Send Message Open Internet Explorer Run Program Request Screenshot Network IP Config IP Renew Map Network Drive Quick Ping Resolve hostname (DNS) Scan for Hosts Port Scan Start Sniffer Opens a Message window to send a message to the active user on the agent machine. The message will pop up to the user currently logged in on the agent machine and will disappear after 60 seconds. Opens a URL request window. After entering a URL and clicking OK, an Internet Explorer window opens on the agent machine. This option is only available from the Computer Management screen. Prompts you to enter the path of the executable to run on the agent s desktop. This option is only available from the Computer Management screen. Sends a command to the agent machine to send a screenshot of the desktop. This will update the Computer Management screen, as well as store the screenshot in the LTShare\Screenshots folder. This option is only available from the Computer Management screen. Requests the IPConfig information from the agent machine. This information will be displayed on the Console of the Control Center. Sends a command to the agent machine to renew its IP address and send the new information back to the Console in the Control Center. Maps a network drive to the agent machine. Will display on the Drives tab as a network share after Resend Disks has run. Sends a packet to a designated IP address or host name and returns the ping results to the Console in the Control Center. Prompts you enter a hostname to resolve. An A record exists which maps the hostname for the domain (yourdomain.com) to an IP address and will return results of an IP address if successful. An error indicates that the DNS that translates your domain name into an IP address failed to respond during the test cycle. The results are returned to the Console in the Control Center. Scans the local network for available hosts. Used primarily in scripts. Scans the host for available TCP ports. This is used primarily with scripts. Starts a packet sniffer on the remote machine for a specified amount of time. The log will be uploaded to the LTShare/sniffer file Commands 7

8 Commands Wake on LAN packet Sends a Wake on LAN packet to the computer; this can only be accomplished if there is an active computer on the network. Shutdown: When using one of the shutdown commands, the user of the agent computer is notified based on the settings in the agent template s Access Mode tab Hibernate Logoff Reboot Reboot to Safe mode Reboot to Safe mode with Command prompt Last Known Good Suspend Shutdown LabTech Force Remote to Update Send LabTech Error Log Uninstall LabTech Restart LabTech Agent Update Plugins Tracing Sends a command to the agent computer to enter hibernation. This will not work on a Windows 7 machine. Sends a command to the agent computer to log off the current user. Sends a command to the agent system to reboot the system. Sends a command to the agent system to reboot in safe mode. Sends a command to the agent system to reboot in safe mode with command prompt. In order to exit this mode you have to reboot the machine from the LabTech server (Commands > Shutdown > Reboot). Sends a command to the agent system to reboot to the last known good configuration. The last known good configuration is dictated by the Windows Registry after the last successful shutdown. Sends a command to the agent system to suspend activity. This will not work on a system that does not support suspend status. Send a command to the agent system to shutdown. Forces the agent to update to the latest version of LabTech. Used for debugging. Sends the LTerror.txt back to the server. Silently uninstalls the agent from the machine. No further commands can be sent since the services will be shutting down. Restarts the remote LabTech agent. This is the same as restarting the LTService by selecting Restart Service on the Services tab of an agent machine. Downloads enabled remote agent-based plugins to the agent and refreshes them in memory. Use this command if you have updated any remote plugins (e.g., downloaded from the Marketplace). Sets the level of agent debugging on the agent machine. The higher the tracing level, the more logging and will appear in the remote agent s log files located in %windir%\ltsvc\lterrors.txt Commands 8

9 LabTech Probe: These commands will only be available if the machine accessed is a network probe. For more information, refer to the Network Probe documentation. Disable collection Enable collection FasTalk Purge Devices Push LabTech to PC Refresh Configuration Start Network Scan Trace Dump Tracing LogMeIn LogMeIn Disables the collection of data on detected devices. Enabled the collection of data on detected devices based on the collection templates. Puts the probe into FasTalk mode, which means it will check into the server at a greater frequency. This is useful if you are going to be walking several devices and will allow you to retrieve commands faster. Purges all the devices for this location from the database and cache and allows you to start over. Pushes an agent to a specific computer provided you have the hostname of IP address of that computer. Refreshes the configuration of the probe, as well as detection and collection templates. Scans the network for new devices. Writes a log file named LTProbeTraceDump.txt to the %windir%\ltsvc directory. This is used for diagnostic purposes only. Gives information on background program threads related to the network probe and includes information on the status of the threads and their watchdog counts. If the watchdog count is extremely high, as in the millions, it may indicate that the thread has stalled or is listening for specific information. Tracing sets the diagnostic levels within the probe and creates a log file to assist in troubleshooting any issues. Available Options for monitoring: Generic Supervisor SNMP Traps Syslog Netflow Discovery Detection Collection Push Count The file named, LTprobeerrors.txt, is saved in the %windir%\ltsvc directory. Opens a web browser window requesting login information for LogMeIn. Refer to the LogMeIn documentation for more information Commands 9

10 Commands Creating a Script from a Command Scripts can be created from most LabTech internal commands. Once a command is made into a script, it can then be scheduled. To create a script from a command: 1. Hold down the [Shift] key while issuing the command to the computer. This will open your Script Editor. 2. The script will automatically be given a name based on the command selected. If you make any changes, click the Save button; otherwise, click Close. The script will appear on the navigation tree in Scripts > Actions. Document Revision History Date Notes 08/06/2012 New Document Commands 10