Skip to main content

How to Log Off the Current User in Batch Script

Logging a user off their Windows session is a common task in administrative scripts. You might need to force a logoff at the end of a workday in a corporate environment, complete a software uninstallation that requires the user session to end, or simply create a convenient "log off" shortcut.

This guide will teach you how to use the standard, built-in shutdown command to safely log off the current user. While its name implies shutting down the computer, a specific switch allows it to target the user session instead. We will also cover the older logoff command for completeness.

The Core Command: shutdown /l​

The shutdown.exe utility is the modern and most powerful tool for controlling system power states, including shutting down, restarting, and logging off. It is the recommended command for this task.

Syntax: shutdown /l

  • /l: This is the crucial switch. It instructs the command to Log off the current user. This will not shut down or restart the computer.

This command is clean, simple, and instantly initiates the standard Windows logoff procedure, which gives running applications a chance to close gracefully.

Alternative Command: logoff​

Windows also includes a dedicated logoff.exe command. In most cases, it behaves identically to shutdown /l.

Syntax: logoff

While this command is shorter and more descriptive, shutdown.exe is the more versatile tool to learn, as it can also handle restarts (/r) and shutdowns (/s). For consistency in scripting, it's often better to use shutdown for all power-related state changes.

Basic Example: A Simple Logoff Script​

This script will immediately log the current user off when executed.

danger

Save your work before running this script!

@ECHO OFF
ECHO This script will now log you off.
ECHO Please save any open work.

REM Give the user a moment to read the message.
TIMEOUT /T 5

ECHO Logging off now...
shutdown /l
note

When you run this, you will see the messages, and after 5 seconds, your Windows session will end, and you will be returned to the login screen.

Let's see how the command works:

  • Both shutdown /l and logoff call the underlying Windows operating system functions to terminate the current user's session. This is the same process that is initiated when you click "Sign out" from the Start Menu.
  • It triggers a system-wide message that tells all running applications that the session is ending. This gives well-behaved programs (like Microsoft Word or Notepad) a chance to prompt the user to save any unsaved work. If applications do not respond, Windows will eventually force them to close to complete the logoff.

Common Pitfalls and How to Solve Them​

Problem: The Logoff is Abrupt and Causes Data Loss​

If you run shutdown /l without any warning, the user might have unsaved work open. While many applications will try to prompt the user to save, a forceful logoff can sometimes cause them to close before the user can respond.

Solution: Always provide a clear warning and a countdown before initiating a logoff. The TIMEOUT command is the perfect tool for this.

ECHO WARNING: You will be logged off in 60 seconds.
ECHO Please save all your work.
TIMEOUT /T 60
shutdown /l

This gives the user a 1-minute window to save their work and close applications before the command is executed.

Problem: Needing to Log Off a Remote User​

Both shutdown /l and logoff can be used to log off a user on a remote machine, but the syntax is different for each. This requires administrative privileges on the remote computer.

  • Using logoff (Simpler): The logoff command has built-in remote capabilities. You first need to find the session ID of the user. 
    REM Step 1: Find the session ID for the user on the remote server
    C:\> quser /SERVER:MyRemoteServer

    REM Step 2: Use that ID with the logoff command
    logoff 2 /SERVER:MyRemoteServer
  • Using shutdown: The shutdown command can force a remote logoff, but it is less targeted. This command logs off anyone using the console of the remote machine. 
    shutdown /l /m \\MyRemoteServer

For remotely logging off a specific user, the logoff command is generally more direct.

Practical Example: A "Save and Logoff" Script​

This script is designed to be placed on a user's desktop. It first opens a common application (Notepad) to remind the user to save their work, gives them time to do so, and then proceeds with the logoff.

@ECHO OFF
SETLOCAL
TITLE Log Off Assistant

ECHO --- Save and Log Off ---
ECHO.
ECHO This script will help you save your work and then log off.
ECHO.
ECHO Opening Notepad now. Please check and save any important notes.
START "" notepad.exe

ECHO.
ECHO You will be logged off in 2 minutes (120 seconds).
ECHO Please use this time to save your work in all other applications.

TIMEOUT /T 120

ECHO.
ECHO Logging off now...
shutdown /l

ENDLOCAL

Conclusion​

Logging off the current user is a simple and direct task in batch scripting, with two effective, built-in commands available.

  • The shutdown /l command is the recommended modern approach. It is part of the versatile shutdown utility and provides a clean and reliable way to end the user session.
  • The logoff command is a perfectly acceptable alternative that is slightly more descriptive but less versatile overall.

The most important best practice is to always provide a clear warning and a countdown (TIMEOUT) before executing the logoff command to prevent accidental data loss for the user.

Table of Contents