Dell iDRAC Service Module 5.0.1.0 User’s Guide
Invoke-SupportAssistCollection
Invoke-SupportAssistCollection is a CLI-based tool that is used for Dell SupportAssist Collection (SAC) from the host operating system. The tool is designed for operating system administrators and the Dell Technologies technical support team who are not aware of iDRAC credentials to log in and initiate the SAC, or when administrators do not have access to iDRAC. Invoke-SupportAssistCollection facilitates the SAC without logging in to the iDRAC.
The Invoke-SupportAssistCollection tool collects filtered SAC which contains system information, storage information and OSC collection details. To run the tool, ensure that you fulfill the following requirements:
- Access PowerEdge yx4x and later servers.
- Log in to the operating system with administrator privileges.
- iSM is running and communicating with iDRAC during tool invocation and execution.
Default invocation of Invoke-SupportAssistCollection tool collects the SAC, and saves the collection into a default download path that is predefined by the operating system. The tool also supports the custom option using which you can pass the operating system directory path where SAC is saved.
Starting from iDRAC Service Module 4.3.0.0, the Invoke-SupportAssistCollection tool is enhanced to upload the SupportAssist Collection to Dell SupportAssist server. A single SupportAssist Collection or upload at a time is supported. To upload the SupportAssist Collection from the host operating system using the Invoke-SupportAssistCollection, you must accept the terms and conditions of the End User License Agreement (EULA). The feature requires active internet connection. A proxy configuration can also be provided to access the internet.
| CLI options | Description |
|---|---|
| [--help/-h] | To display the help content. |
| [--filepath/-f] <Destination directory> | Use this option to download SupportAssist Collection to the user-specified directory. This option cannot be used with any other options. |
| [--upload/-u] | Use this option to upload SupportAssist Collection to Dell SupportAssist server. This option does not save the collection locally. |
| [--proxy/-p] <proxyip:port> | Optional parameter used with upload option. Use this option to provide proxy server IP and port number. |
| [--id/-i] <username> | Optional parameter used with upload option. Use this option to enter proxy username as parameter, and password at the Command Line Interface (CLI). |
| [--ignore-os-logs/-g] | Run to ignore collecting the operating system log data. This command is supported only on VMware ESXi operating system. |
NOTE When
-i or
-p options are not entered in the Invoke-SupportAssistCollection tool, then the tool continues execution without generating any error message. According to the design of getopt API, the tool does not consider command-line option-argument entered, that is supposed to be entered along with the option.
For example, in the command Invoke-SupportAssistCollection -u <ProxyIPaddress:Port>, the option-argument is ignored. Any option-argument that requires the option must be entered as mentioned in the help option of the tool.
You can also perform the SupportAssist Collection function from the operating system shell to a specified file path using the command:
./ Invoke-SupportAssistCollection [--filepath/-f]
NOTE The shell command is only supported on iDRAC9 in the PowerEdge yx4x and later servers, when logged into the operating system as an administrator.
NOTE On Windows Core operating system, you must go to the absolute path to run the command
Invoke-SupportAssistCollection.exe .
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please select whether the article was helpful or not.
Comments cannot contain these special characters: <>()\