Synopsis
poffcli HostName [/sd:ShutdownMode] [/ef] [/rc:nn /ri:nnnn]
Description
The poffcli command powers off the client that supports the Windows power-off mechanism. It enables a remote client to be turned off automatically.
Parameters
HostName
Specifies a host name of the client to be powered off.
Specify the host name in HostName within 15 alphanumeric characters. If HostName contains a space character, enclose it in double quotation marks.
/sd:ShutdownMode
Specifies the mode to turn off the power. Select one of the following:
Turns off the system power.
Reboots the system.
Shuts down the system.
If omitted, the system is turned off as the poff mode is defaulted.
/ef
Specifies forced power off.
Specifying this parameter forces the running application to be terminated. At this time, the data used by those applications is not saved.
The active desktop on the client should be disabled. Otherwise, the active desktop recovery function may be started automatically the next time you start the OS.
/rc:nn
Specifies the retry count in case an error occurs in powering off clients.
Specify an integer value between 0 and 99 for nn. Setting any other value results in an error. If omitted, no retry is performed.
/ri:nnnn
Specifies the retry interval in case an error occurs.
Specify an integer value between 0 and 9999 (in seconds) for nnnn. Setting any other value results in an error. The default value is 0.
This parameter is valid if 1 or a greater value is specified to nn in the /rc parameter.
Return Values
Return value | Meaning |
|---|---|
0 | Completed |
Value other than 0 | Abended |
Command Location
Solaris | /opt/FJSVsnjss/bin |
HP-UX | /opt/FHPsnjss/bin |
AIX | /opt/FAIXsnjss/bin |
Linux | /opt/FJSVsnjss/bin |
Example
The following example performs power off for the client "foo".
poffcli foo /sd:poff
Execution Results/Output Format
After the command has been through processing, the information at command completion is output to the standard output.
The contents to be output are shown below:
[Process start time] MM-DD-YYYY HH:MM:SS [Client host name] HostName [Retry count] Number of retries performed [Error] Error message [Process end time] MM-DD-YYYY HH:MM:SS
In [Error], "None" is output if the command completed successfully. A message is output if the command is canceled or failed. For details on the messages, see the Systemwalker Operation Manager Message Guide.
If an error occurs before power off, a message is output in the following format:
[Process start time] MM-DD-YYYY HH:MM:SS [Command error] Error message [Process end time] MM-DD-YYYY HH:MM:SS
For details on the messages, see the Systemwalker Operation Manager Message Guide.
Cautions
The Client Task Link service must be already working on the client side when you use this command. At this time, the Client Task Link service must be started by the user having privileges to power off clients.
The client that can be powered off using this command must be a computer supporting the Windows power-off mechanism.
If a running application is not terminated in response to a termination request sent from Windows, it may not be possible to power off the client.
If the /ef parameter is specified, applications that do not respond to a Windows' termination request are forcefully terminated by Windows.
The specification by the /rc parameter or /ri parameter becomes valid only when the user logged on to the target client does not have the shutdown privilege in Windows operating systems.
