100% found this document useful (2 votes)
68 views59 pages

Instant Download Windows CMD Command Syntax Unknown PDF All Chapter

ebook

Uploaded by

tiriraropsa
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
100% found this document useful (2 votes)
68 views59 pages

Instant Download Windows CMD Command Syntax Unknown PDF All Chapter

ebook

Uploaded by

tiriraropsa
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 59

Full download test bank at ebook ebookstep.

com

Windows CMD Command Syntax Unknown

DOWLOAD EBOOK
OR CLICK LINK

http://ebookstep.com/product/windows-cmd-command-
syntax-unknown/

Go to download the full and correct Download More ebooks [PDF].


content document Format PDF ebook download PDF
https://ebookstep.com KINDLE
More products digital (pdf, epub, mobi) instant
download maybe you interests ...

Windows Commands Complete Unknown

https://ebookstep.com/product/windows-commands-complete-unknown/

Windows Command Line Administrator s Pocket Consultant


Second Edition eBook William Stanek

https://ebookstep.com/product/windows-command-line-administrator-
s-pocket-consultant-second-edition-ebook-william-stanek/

Under His Command Carmen Labohemian

https://ebookstep.com/product/under-his-command-carmen-
labohemian/

Kekasih di Fiore Christmas at the Tycoon s Command


Jennifer Hayward

https://ebookstep.com/product/kekasih-di-fiore-christmas-at-the-
tycoon-s-command-jennifer-hayward/
Microsoft Windows Azure ■■■■■■■■■■ ■.■.

https://ebookstep.com/download/ebook-5693548/

SYNTAX ■ ■■■■■ ■■■■■■ ■■■■■■ 13th Edition ■ ■ ■ ■■■■■


■■

https://ebookstep.com/download/ebook-43685728/

Yog vigyan 1st Edition Unknown

https://ebookstep.com/product/yog-vigyan-1st-edition-unknown/

Windows 11 3rd Edition Jörg Hähnle

https://ebookstep.com/product/windows-11-3rd-edition-jorg-hahnle/

Mechanical Dept Formula 1st Edition Unknown

https://ebookstep.com/product/mechanical-dept-formula-1st-
edition-unknown-2/
Windows CMD Command Syntax | SS64.com

( SS64 ) CMD Links


Search

Windows CMD Shell Command Line Syntax


Parameters Command Line Arguments %1 %~f1
RUN commands Start | Run commands.
MMC Snap-ins Admin commands.
Shell: folder Shortcuts to key folders.
ProfileFolders Location of User profile folders (XP / W7 / W10).
Env. Variables Create/read environment variables.
Redirection Spooling output to a file, piping input.
AND/OR Logic Conditional Execution (If-Then-Else)
Loops Loops and Subroutines.
functions How to package blocks of code.
Macros Embed blocks of code in a variable.

Services      List of Windows 7 (SP1) Services.


Evaluating expressions
Using brackets to Group and expand expressions.
Delayed Expansion Variables within loops.
Escape chars, delimiters and quotes
SET /A Environment variable arithmetic.
VarSubstring Extract part of a variable (substring).
VarSearch Search & replace part of a variable.
RANDOM Random Numbers.
Wildcards Match multiple files.
Batch Files
Run a script How to run a script.
Elevate Run with elevated permissions (As Admin).
DateMath Add or subtract days from any date.
DeQuote Remove quotes from a string.
DelOlder Delete files more than n days old.
GenChr.cmd Generate an ASCII/Unicode character.
GetDate.cmd Get todays date (any region, any OS.)
GetTime.cmd Get the time now.
GetGMT.cmd Time adjusted to Greenwich Mean Time.
StampMe.cmd Rename a file with the date/time.
tdiff.cmd Time difference in Hours/Minutes.
Which.cmd Display full path to any command.
xlong.cmd Find filenames that exceed the 256 char pathname limit.
Reference/How to
Autoexec Run commands at startup.
Slow Browsing Speed up network browsing.
Desktop Heap Memory configuration.
Long Filenames NTFS filename issues.
Display DPI Monitor size settings.
CMD Shell Working in the Windows CMD shell.
CMD Internal Commands that are Internal to the CMD shell.
File Shares Organising shared files.
Keyboard CMD Keyboard shortcuts.
NoDrives Hide mapped drives from Windows Explorer.
Printing Printer connections and print drivers.
Recovery The Recovery Console.
Reg Tweaks Registry tweaks and settings.
BuiltIn Groups Built-In Users and Security Groups.
Groups Local Domain groups, Global and Universal groups.
64Bit Detect 64 bit vs 32 bit Windows.
Windows Key Shortcut keys

Related:

Microsoft.com - Command-line Reference


Recommended books and Websites

Copyright © SS64.com 1999-2017


Some rights reserved

https://ss64.com/nt/syntax.html[8/24/2017 10:32:39 AM]


SS64 | Command line reference

( SS64 ) Search

Command line reference – Database and OS scripting.

Bash macOS CMD PowerShell

Access VB Script Oracle SQL Server

ASCII Convert MB/GB Forum Passwords

About/contact - Last update: August 23rd


Copyright © SS64.com 1999-2017, some rights reserved.

https://ss64.com/[8/24/2017 10:32:42 AM]


An A-Z Index of the Windows CMD command line | SS64.com

( SS64 ) Links Syntax


Search

An A-Z Index of the Windows CMD command line


ADDUSERS Add or list users to/from a CSV file
ADmodcmd Active Directory Bulk Modify
ARP Address Resolution Protocol
ASSOC Change file extension associations•
ASSOCIAT One step file association
AT Schedule a command to run at a specific time
ATTRIB Change file attributes
b
BCDBOOT Create or repair a system partition
BCDEDIT Manage Boot Configuration Data
BITSADMIN Background Intelligent Transfer Service
BROWSTAT Get domain, browser and PDC info
c
CACLS Change file permissions
CALL Call one batch program from another•
CERTREQ Request certificate from a certification authority
CERTUTIL Utility for certification authority (CA) files and services
CD Change Directory - move to a specific Folder•
CHANGE Change Terminal Server Session properties
CHKDSK Check Disk - check and repair disk problems
CHKNTFS Check the NTFS file system
CHOICE Accept keyboard input to a batch file
CIPHER Encrypt or Decrypt files/folders
CleanMgr Automated cleanup of Temp files, recycle bin
CLIP Copy STDIN to the Windows clipboard
CLS Clear the screen•
CMD Start a new CMD shell
CMDKEY Manage stored usernames/passwords
COLOR Change colors of the CMD window•
COMP Compare the contents of two files or sets of files
COMPACT Compress files or folders on an NTFS partition
COMPRESS Compress one or more files
CONVERT Convert a FAT drive to NTFS
COPY Copy one or more files to another location•
Coreinfo Show the mapping between logical & physical processors
CSCcmd Client-side caching (Offline Files)
CSVDE Import or Export Active Directory data
d
DATE Display or set the date•
DEFRAG Defragment hard drive
DEL Delete one or more files•
DELPROF Delete user profiles
DELTREE Delete a folder and all subfolders
DevCon Device Manager Command Line Utility
DIR Display a list of files and folders•
DIRQUOTA File Server Resource Manager Disk quotas
DIRUSE Display disk usage
DISKPART Disk Administration
DISKSHADOW Volume Shadow Copy Service
DISKUSE Show the space used in folders
DOSKEY Edit command line, recall commands, and create macros
DriverQuery Display installed device drivers
DSACLs Active Directory ACLs
DSAdd Add items to active directory (user group computer)
DSGet View items in active directory (user group computer)
DSQuery Search for items in active directory (user group computer)
DSMod Modify items in active directory (user group computer)
DSMove Move an Active directory Object
DSRM Remove items from Active Directory
Dsmgmt Directory Service Management
e
ECHO Display message on screen•
ENDLOCAL End localisation of environment changes in a batch file•
ERASE Delete one or more files•
EVENTCREATE Add a message to the Windows event log
EXIT Quit the current script/routine and set an errorlevel•
EXPAND Uncompress CAB files
EXPLORER Open Windows Explorer
EXTRACT Uncompress CAB files
f
FC Compare two files
FIND Search for a text string in a file
FINDSTR Search for strings in files
FLTMC Manage MiniFilter drivers
FOR /F Loop command: against a set of files•
FOR /F Loop command: against the results of another command•
FOR Loop command: all options Files, Directory, List•
FORFILES Batch process multiple files
FORMAT Format a disk
FREEDISK Check free disk space
FSUTIL File and Volume utilities
FTP File Transfer Protocol
FTYPE File extension file type associations•
g

https://ss64.com/nt/[8/24/2017 10:32:43 AM]


An A-Z Index of the Windows CMD command line | SS64.com

GETMAC Display the Media Access Control (MAC) address


GOTO Direct a batch program to jump to a labelled line•
GPRESULT Display Resultant Set of Policy information
GPUPDATE Update Group Policy settings
h
HELP Online Help
HOSTNAME Display the host name of the computer
i
iCACLS Change file and folder permissions
IEXPRESS Create a self extracting ZIP file archive
IF Conditionally perform a command•
IFMEMBER Is the current user a member of a group
IPCONFIG Configure IP
INUSE Replace files that are in use by the OS
l
LABEL Edit a disk label
LODCTR Load PerfMon performance counters
LOGMAN Manage Performance Monitor logs
LOGOFF Log a user off
LOGTIME Log the date and time in a file
m
MAKECAB Create .CAB files
MAPISEND Send email from the command line
MBSAcli Baseline Security Analyzer
MEM Display memory usage
MD Create new folders•
MKLINK Create a symbolic link (linkd) •
MODE Configure a system device COM/LPT/CON
MORE Display output, one screen at a time
MOUNTVOL Manage a volume mount point
MOVE Move files from one folder to another•
MOVEUSER Move a user from one domain to another
MSG Send a message
MSIEXEC Microsoft Windows Installer
MSINFO32 System Information
MSTSC Terminal Server Connection (Remote Desktop Protocol)
n
NET Manage network resources
NETDOM Domain Manager
NETSH Configure Network Interfaces, Windows Firewall & Remote access
NBTSTAT Display networking statistics (NetBIOS over TCP/IP)
NETSTAT Display networking statistics (TCP/IP)
NLSINFO Display locale information (reskit).
NLTEST Network Location Test (AD)
NOW Display the current Date and Time
NSLOOKUP Name server lookup
NTBACKUP Backup folders to tape
NTDSUtil Active Directory Domain Services management
NTRIGHTS Edit user account rights
NVSPBIND Modify network bindings
o
OPENFILES Query or display open files
p
PATH Display or set a search path for executable files•
PATHPING Trace route plus network latency and packet loss
PAUSE Suspend processing of a batch file and display a message•
PERMS Show permissions for a user
PERFMON Performance Monitor
PING Test a network connection
POPD Return to a previous directory saved by PUSHD•
PORTQRY Display the status of ports and services
POWERCFG Configure power settings
PRINT Print a text file
PRINTBRM Print queue Backup/Recovery
PRNCNFG Configure or rename a printer
PRNMNGR Add, delete, list printers and printer connections
ProcDump Monitor an application for CPU spikes
PROMPT Change the command prompt•
PsExec Execute process remotely
PsFile Show files opened remotely
PsGetSid Display the SID of a computer or a user
PsInfo List information about a system
PsKill Kill processes by name or process ID
PsList List detailed information about processes
PsLoggedOn Who's logged on (locally or via resource sharing)
PsLogList Event log records
PsPasswd Change account password
PsPing Measure network performance
PsService View and control services
PsShutdown Shutdown or reboot a computer
PsSuspend Suspend processes
PUSHD Save and then change the current directory•
q
QGREP Search file(s) for lines that match a given pattern
Query Process / QPROCESS Display processes
Query Session / QWinsta Display all sessions (TS/Remote Desktop)
Query TermServer /QAppSrv List all servers (TS/Remote Desktop)
Query User / QUSER Display user sessions (TS/Remote Desktop)
r
RASDIAL Manage RAS connections
RASPHONE Manage RAS connections
RECOVER Recover a damaged file from a defective disk
REG Registry: Read, Set, Export, Delete keys and values

https://ss64.com/nt/[8/24/2017 10:32:43 AM]


An A-Z Index of the Windows CMD command line | SS64.com

REGEDIT Import or export registry settings


REGSVR32 Register or unregister a DLL
REGINI Change Registry Permissions
REM Record comments (remarks) in a batch file•
REN Rename a file or files•
REPLACE Replace or update one file with another
Reset Session Delete a Remote Desktop Session
RD Delete folder(s)•
RMTSHARE Share a folder or a printer
ROBOCOPY Robust File and Folder Copy
ROUTE Manipulate network routing tables
RUN Start | RUN commands
RUNAS Execute a program under a different user account
RUNDLL32 Run a DLL command (add/remove print connections)
s
SC Service Control
SCHTASKS Schedule a command to run at a specific time
SET Display, set, or remove session environment variables•
SETLOCAL Control the visibility of environment variables•
SetSPN Edit Service Principal Names
SETX Set environment variables
SFC System File Checker
SHARE List or edit a file share or print share
ShellRunAs Run a command under a different user account
SHIFT Shift the position of batch file parameters•
SHORTCUT Create a windows shortcut (.LNK file)
SHUTDOWN Shutdown the computer
SIGCHECK Display file version no. VirusTotal status & timestamp
SLEEP Wait for x seconds
SLMGR Software Licensing Management (Vista/2008)
SORT Sort input
START Start a program, command or batch file•
STRINGS Search for ANSI and UNICODE strings in binary files
SUBINACL Edit file and folder Permissions, Ownership and Domain
SUBST Associate a path with a drive letter
SYSMON Monitor and log system activity to the Windows event log
SYSTEMINFO List system configuration
t
TAKEOWN Take ownership of a file
TASKLIST List running applications and services
TASKKILL End a running process
TELNET Communicate with another host using the TELNET protocol
TIME Display or set the system time•
TIMEOUT Delay processing of a batch file
TITLE Set the window title for a CMD.EXE session•
TLIST Task list with full path
TOUCH Change file timestamps
TRACERT Trace route to a remote host
TREE Graphical display of folder structure
TSDISCON Disconnect a Remote Desktop Session
TSKILL End a running process
TSSHUTDN Remotely shut down or reboot a terminal server
TYPE Display the contents of a text file•
TypePerf Write performance data to a log file
TZUTIL Time Zone Utility
v
VER Display version information•
VERIFY Verify that files have been saved•
VMConnect Connect to a Hyper-V Virtual Machine
VOL Display a disk label•
w
W32TM Time Service
WAITFOR Wait for or send a signal
WBADMIN Windows Backup Admin
WECUTIL Windows Event Collector Utility
WEVTUTIL Clear event logs, enable/disable/query logs
WHERE Locate and display files in a directory tree
WHOAMI Output the current UserName and domain
WINDIFF Compare the contents of two files or sets of files
WINRM Windows Remote Management
WINRS Windows Remote Shell
WMIC WMI Commands
WPEUTIL Run WinPE commands
WPR Windows Performance Recorder
WUAUCLT Windows Update
x
XCACLS Change file and folder permissions
XCOPY Copy files and folders
:: Comment / Remark•

Commands marked • are Internal commands only available within the CMD shell.
All other commands (not marked with •) are external commands.
External commands may be used under the CMD shell, PowerShell, or directly from START-RUN.

See also: a categorized list of Windows CMD commands


Microsoft Help pages: 2003 Server, 2008 Server, Windows 7/Server 2012 / Technology
Discussion forum
Links to other sites, books etc...

https://ss64.com/nt/[8/24/2017 10:32:43 AM]


An A-Z Index of the Windows CMD command line | SS64.com

Copyright © SS64.com 1999-2017


Some rights reserved

https://ss64.com/nt/[8/24/2017 10:32:43 AM]


Windows Resource Kits, Books and Websites - SS64.com

( SS64 ) CMD

Websites, Resource Kits, Books and Utilities


Windows 7/2008 Command Reference - Microsoft
Windows 2008/R2 Commands Help file - Microsoft
Old New Thing - Raymond Chen, Microsoft
Microsoft Security Response Center (MSRC) - Microsoft)
Security Bulletins 2017 - Microsoft Security TechCenter
Microsoft Update Catalog - Search for specific updates by KB#

Rob van der Woude.com - Batch files, VBS


CommandLine - Batch File examples and Utilities.
Timo Salmi - Useful script tricks and tips.

Resource Kits + updates


Many resource kit tools and utilities will run successfully on multiple versions of Windows. However Active Directory and
NTFS have changed significantly over the years so I recommend you only use the tools supported for your platform.

Windows 7 Resource Kit


By Mitch Tulloch, Tony Northrup & Jerry Honeycutt
1,700 pages, Deploy, Manage, Maintain and Troubleshoot. Example VBS and PowerShell scripts, sample chapter
(PDF.)

Windows 10 Remote Server Administration Tools (RSAT) KBase


Windows 2008/2012 Remote Server Administration Tools (RSAT) Built-in feature
WIndows 8.1 Remote Server Administration Tools (RSAT) KBase
Windows 8 Remote Server Administration Tools (RSAT) KBase
Windows 7 Remote Server Administration Tools (RSAT) KBase
RSAT includes Active Directory Domain Services Tools, elements of the RSAT package can be enabled under
Control Panel | Programs and Features | Windows features.

Windows Server 2008 Resource Kit - April 2008


By Microsoft Corp
4,000 pages + DVD with more than 200 essential tools and scripts.

Deployment tools
Windows 10 - ISO download
N edition = No Media Player or IE DRM or Camera.
KN edition = Korean

Windows Assessment and Deployment Kit (Windows ADK) - Customize Windows 10 images for large-scale
deployment.
Microsoft Deployment Toolkit (MDT) 2013 Update 2 [news] - Automate desktop and server OS deployments.

Other Windows Toolkits:


Sysinternals Suite - Download the Sysinternals utilities.

https://ss64.com/links/windows.html[8/24/2017 10:32:44 AM]


Windows Resource Kits, Books and Websites - SS64.com

ADModify - A GUI tool to facilitate making bulk user attribute modifications.

Windows 7 /8 / 2008 / 2012 Assessment and Deployment Kit (ADK)


Windows 7 /8.1/ 2008 R2 /2012 Assessment and Deployment Kit (ADK update)

Microsoft Application Compatibility Toolkit - Evaluate and mitigate application compatibility issues for Vista and
Windows 7. Includes the Compatibility Administrator which can be used to set UAC exceptions (Application fix.)

Account Lockout Status (LockoutStatus.exe) - Display lockout information for a particular user account (Aug
2012).

Account Lockout and Management Tools - Includes LockoutStatus, plus tools to troubleshoot account lockouts,
and display password ages(Aug 2012).

Microsoft Baseline Security Analyzer - Scan local and remote systems for missing security updates.

SMB1 How to disable it - Windows 7 up to Windows Server 2016

Elevation PowerToys for Windows Vista + Elevation blog

File Checksum Integrity Verifier (FCIV) - Compute and verify cryptographic hash values for files.

Policy Analyzer from Aaron Margosis - Compare sets of Group Policy Objects (GPOs). Highlight redundant
settings or internal inconsistencies.

Group Policy Management Console SP1 & Group Policy Object Settings spreadsheet 2003/2008/2008R2/Win7

Local Administrator Password Solution (LAPS) - Manage local account passwords of domain joined computers
(howto)

Remote Desktop Connection Manager - RDP to multiple machines.

Windows Help - Install Windows 7/8 Help, fix for 'Help not supported' errors.

WMI Diagnosis Utility - Diagnose and repair problems with the WMI service.

Recommended Books.

Batchography: The Art of Batch Files Programming


by Elias Bachaalany
Discover the lost art of Batch file programming, start with the basics of manipulating numbers, strings and
variables and move on to looping operations, recursion, debugging and troubleshooting of your scripts. The final
chapter has a number of batch file recipes: parsing .ini files, creating interactive menus and more. Highly
recommended.

SysInternals Administrator's Reference


by Mark E. Russinovich
Guidance and inside insights for the Windows Sysinternals tools. Guided by Sysinternals creator Mark
Russinovich and Windows expert Aaron Margosis

https://ss64.com/links/windows.html[8/24/2017 10:32:44 AM]


Windows Resource Kits, Books and Websites - SS64.com

Windows 7 and Vista Guide to Scripting, Automation, and Command Line Tools
By Brian Knittel
A complete guide covering VBScript, traditional batch files, and PowerShell.

Windows Internals, Part 1 and Part2


by Mark E. Russinovich, David A. Solomon and Alex Ionescu
Insider perspectives and hands-on experiments to demonstrate how Windows operates.

Windows 10: The Missing Manual


by David Pogue
An enjoyable but still very detailed read with lot's of good tips and keyboard shortcuts.

Mark Minasi's Mastering Windows Server 2012 R2


by Mark Minasi.
Comprehensive and understandable guide. Improve the performance and manageability of your network.
minasi.com

Windows NT Shell Scripting


by Tim Hill.
First published in 1998 so no mention of VBS or Powershell, despite this it's still a solid introduction to writing
batch files under Windows. Sample chapter.

Also see - Recommended VBScript Books

Utilities - Command line


SysInternals - Microsoft System utilities.
Joeware.net - Admin, AD and Exchange tools.
Nirsoft Utilities and NirCMD freeware Command-Line Tool.

Console 2 - Windows console emulator for CMD and/or PowerShell (review)


ConEmu-Maximus5 - Windows console emulator for CMD and/or PowerShell (review)
CommandLine.co.uk - Useful tools (free Win32 utilities - mostly console)
CryptoPrevent - A Group Policy to block executables from specific paths.
Cygwin - Linux-like environment for Windows, tutorial: 1, 2, 3
FastCopy - An alternative to RoboCopy.
Frank P. Westlake Batch Scripts + mirror of older console utilities.
Gow - Lightweight UNIX utilities compiled as native win32 binaries.
HoboCopy - open-source backup tool (can copy open files)
Jason Hood - Utilities including Search & Replace, Date/Time, ANSI escape recognition for CMD.
Npocmaka - Batch scripts, zipjs.bat + others

https://ss64.com/links/windows.html[8/24/2017 10:32:44 AM]


Windows Resource Kits, Books and Websites - SS64.com

PDFtk - Command-line tool for processing PDFs


Petter Nordahl-Hagen - Offline Windows Password & Registry Editor
pretentiousname - Utilities by Leo Davidson
Repl.bat - FInd and Replace text, JScript/Batch script
FindRepl.bat - FInd and Replace text, JScript/Batch script
SetRes - Set screen resolution (Ian Sharpe)
Bill Stewart - Batch script and Windows admin tools (TrueLast LogonTime)
SetACL - Utility to manage permissions, auditing and ownership (free)
System Tools - Dump Event Log, Registry or Security info
unxutils - Port of unix utilities to run under the CMD shell

Package Managers
Chocolatey - Package manager for Windows
Ninite - Automate software installations and updates.

Utilities - GUI
Agent Ransack - File Search (search all file types)
AIMP3 - Fully featured free music player.
Autohotkey - Automate keystrokes, mouse clicks.
AutoIT - GUI scripting
CamStudio - Record screen and audio activity on your computer.
Clonezilla - Partition and disk imaging/cloning program
CPU-Z - gather information on system devices

Dban - Darik's Boot and Nuke, a boot CD that securely wipes hard disks.
Event Sentry - Event log monitoring

FTP - Cyberduck - FTP client


FTP - FileZilla - FTP client (safe download only via Ninite)
FTP - WinSCP - Free SFTP, SCP and FTP client for Windows

Find And Replace Text - Grep-like utility by Lionello Lunesu (Sourceforge link removed)
Flash uninstall - To allow a full 'clean' reinstall
FlashBlock - Content-filtering extension for Firefox
FileZilla - A cross-platform FTP, FTPS and SFTP client
foobar2000 - freeware audio player
Ghost Solution Suite - Disk / Partition Imaging
Inkscape - Vector Graphics (Illustrator)
imgburn.com - Free CD/DVD/Blu-ray burner
isoRecorder - Burn iso image to bootable CD
Krita - Open Source photo/graphics editor.
Lansweeper - Network Monitoring
Lost NT password
MakeMSI - Build Windows Installer files.
MalwareBytes - Anti Malware, detect and remove worms, Trojans, rootkits, etc.
Metapad - Simple notepad replacement
Notepad++ - Notepad replacement (n.b. the syntax highlighting for parentheses in CMD/BAT files is faulty.)
nLite - pre-installation Windows configuration
Photoshop Elements - Basic photo editing and organisation.
Trinity Rescue Kit - Recovery and repair of Windows machines
Netikus - Password, Ping, FTP, event log alerts.
Panda AntiVirus Free
PhotoRec - Data recovery software - hard disk, CD-ROM & Memory Cards
PuTTY - Free Telnet/SSH Client
Rapid Environment Editor - Edit environment variables
Servers Alive - Network monitoring
SoftPerfect - Search, Scan for open file shares and other utils.
Speccy - System information, hardware and software (serial numbers etc).
Sumatra - PDF viewer

https://ss64.com/links/windows.html[8/24/2017 10:32:44 AM]


Windows Resource Kits, Books and Websites - SS64.com

SyncBack - GUI Backup and synchronize files


SyncToy - Synchronize files and folders
TeamViewer - Screen sharing/Remote control (Mac/PC/Linux)
Textadept - cross-platform text editor.
TightVNC - Remote control
TribbleSoft - Easy Robocopy (GUI)
UnDelete - Condusiv/Diskeeper
USB install for Windows 7 - Copy iso images to a bootable USB stick
WinMerge - open source WinDiff
VirtualBox - Open Source virtualisation for Windows, Linux, Macintosh, and Solaris.
VirtualDub - Process/Edit .AVI files
Virtual PC - Virtualisation for Windows
VLC Media Player - Free versatile media player
VMWare - Free
VueScan - Scanner Software
WiNToBootic - Make bootable USB Flash or Hard Disk
WSUS Offline Update - Microsoft Windows/Office updates from a USB stick.
Wink - Capture screenshots/video, add help text
WsusOffline - Apply Windows Update patches without an internet connection.
Zero Assumption Recovery - data recovery

Find more utilities, or add you own over in the forum

Related

Usenet - news: alt.msdos.batch.nt


DosTips forum
The Scripting Guys Forum - a mix of VBScript, Batch and PowerShell.
SS64 - Windows CMD discussion Forum

MS Support Q no's
913086 »

Search Microsoft Knowledge base


Blue Screen »

“We have prided ourselves on always being the cheapest guy on the block. We have always told our people we're the high volume, low
price guy in the software business" - Steve Ballmer (Partnering for Success)

Copyright © SS64.com 1999-2017


Some rights reserved

https://ss64.com/links/windows.html[8/24/2017 10:32:44 AM]


Parameters / Arguments - Windows CMD - SS64.com

( SS64 ) CMD Syntax


Search

Command Line arguments (Parameters)


A command line argument (or parameter) is any value passed into a batch script:
C:> MyScript.cmd January 1234 "Some value"

Arguments can also be passed to a subroutine with CALL:


CALL :my_sub 2468

You can get the value of any argument using a % followed by it's numerical position on the command line. The first item
passed is always %1 the second item is always %2 and so on

%* in a batch script refers to all the arguments (e.g. %1 %2 %3 %4 %5 ...%255)


only arguments %1 to %9 can be referenced by number.

Parameter Extensions
When an argument is used to supply a filename then the following extended syntax can be applied:

we are using the variable %1 (but this works for any parameter)

%~f1 Expand %1 to a Fully qualified path name - C:\utils\MyFile.txt

%~d1 Expand %1 to a Drive letter only - C:

%~p1 Expand %1 to a Path only e.g. \utils\ this includes a trailing \ which will be interpreted as an escape
character by some commands.

%~n1Expand %1 to a file Name without file extension C:\utils\MyFile or if only a path is present (with no trailing
backslash\) - the last folder in that path.

%~x1 Expand %1 to a file eXtension only - .txt

%~s1 Change the meaning of f, n, s and x to reference the Short 8.3 name (if it exists.)

%~1   Expand %1 removing any surrounding quotes (")

%~a1 Display the file attributes of %1

%~t1 Display the date/time of %1

%~z1 Display the file size of %1

%~$PATH:1 Search the PATH environment variable and expand %1 to the fully qualified name of the first match
found.

The modifiers above can be combined:

%~dp1 Expand %1 to a drive letter and path only

%~sp1 Expand %1 to a path shortened to 8.3 characters

%~nx2 Expand %2 to a file name and extension only

These parameter/ argument variables are always denoted with a single leading %
This is unlike regular variables which have both leading and trailing %'s such as %variable% , or FOR command variables
which use a single leading % on the command line or a double leading %% when used in a batch file.

https://ss64.com/nt/syntax-args.html[8/24/2017 10:32:54 AM]


Parameters / Arguments - Windows CMD - SS64.com

Parameter expansion will treat a Full Stop within a directory name as a file extension, so for a name like "Sample 2.6.4 " the
output of %~n1 will be truncated to "Sample 2.6 " to return the whole folder name use %1 or %~nx1

If the output of DIR, or a filename with no drive letter/path is expanded to display a Full pathname %~f1 the command shell will
assume; often incorrectly; that the file resides in the current directory. The CMD shell does not read file descriptors, or work
with filesystem objects the way that PowerShell does, it is processing a simple list of text strings.

When writing batch scripts it's a good idea to store the values in a named variable SET _LogFile=%~dp1 , the rest of the script
can then refer to the easy-to-read variable name %_LogFile% This will also make life easier if you later need to change around
the order of the parameters.

Tokenization
Tokenization of the command line arguments is not always done by the cmd.exe shell. Most often the tokenization
is done by the newly formed processes' runtime, at the OS level, Windows passes a command line untokenized as
a single string to the new process. You can read more about the low-level details of the batch language/cmd
escaping from the excellent answers by jeb and dbenham on this StackOverflow question.

Passing by Reference
In addition to passing numeric or string values on the command line, it is also possible to pass a variable name
and then use the variable to transfer data between scripts or subroutines. Passing by reference is a slightly more
advanced technique but can be particularly useful when the string contains characters that are CMD delimiters or
quotes.

Links relative to the Batch Script


You can get the pathname of the batch script itself with %0, parameter extensions can be applied to this so %~dp0
will return the Drive and Path to the batch script e.g. W:\scripts\ and %~f0 will return the full pathname
W:\scripts\mybatch.cmd

You can refer to other files in the same folder as the batch script by using this syntax:
CALL %0\..\SecondBatch.cmd

This can even be used in a subroutine, Echo %0 will give the call label but, echo "%~nx0" will give you the filename
of the batch script.

When the %0 variable is expanded, the result is enclosed in quotation marks.

Use %~a1 to display the Extended Attributes of a file.


FOR's %%~aI recognizes 9 NTFS file attributes. The expansion of a file attribute produces a series of 9 dashes,
with each recognized attribute replacing a dash with a letter. A file with no recognized attributes or with none set
will expand to 9 dashes like this: ---------
Attribute Expansion
FILE_ATTRIBUTE_DIRECTORY d--------
FILE_ATTRIBUTE_READONLY -r-------
FILE_ATTRIBUTE_ARCHIVE --a------
FILE_ATTRIBUTE_HIDDEN ---h-----
FILE_ATTRIBUTE_SYSTEM ----s----
FILE_ATTRIBUTE_COMPRESSED -----c---
FILE_ATTRIBUTE_OFFLINE ------o--
FILE_ATTRIBUTE_TEMPORARY -------t-
FILE_ATTRIBUTE_REPARSE_POINT --------l
FILE_ATTRIBUTE_NORMAL ---------

Other NTFS attributes not recognised by %%~aI can be read using FSUTIL usn command:
FILE_ATTRIBUTE_ENCRYPTED
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED
FILE_ATTRIBUTE_SPARSE_FILE

Example: Expansion of a file with the Hidden and System attributes:

https://ss64.com/nt/syntax-args.html[8/24/2017 10:32:54 AM]


Parameters / Arguments - Windows CMD - SS64.com

---hs----

Maximum line length


The maximum length of any command line (or variable) within CMD is 8191 characters.

Terminology: Command-line Argument or Parameter?


In mathematical terms a parameter is "a numerical or other measurable factor" so typically a number.

In programming terminology:
A parameter represents a value that the procedure expects you to pass when you call it.
An argument represents the actual value that you pass to a procedure.

In practice the phrases argument and parameter tend to be used interchangeably, CMD batch files do not perform
any type checking.

FOR parameters
The FOR command creates parameter variables which are identified with a letter rather than a number (e.g. %%G ).
The Parameter Expansions described above can also be applied to these.
To avoid confusion between the two sets of letters, avoid using the letters (a, d, f, n, p, s, t, x, z) as FOR
parameters or just choose a FOR parameter letter that is UPPER case.
So for example in a reference like %%~fG the %%G is the FOR parameter, and the ~f is the Parameter Expansion.

Examples:

Pass parameters from one batch to another:


MyBatch.cmd SMITH 100

Or as part of a CALL :
CALL MyBatch.cmd SMITH 100

Get the file size of C:\demo\sample.xlsx using the %~z parameter extension:
@Echo off
For %%G in ("C:\demo\sample.xlsx") do set _var=%%~zG
Echo File size is %_var%

Passing values from one part of a script to another:


:: Using CALL to jump to a subroutine
CALL :s_staff SMITH 100
:: Calling a subroutine from a FOR command
FOR /F %%G IN ('DIR /b *.*') DO call :s_subroutine %%G

“A gift is pure when it is given from the heart to the right person at the right time and at the right place, and when we expect nothing in
return” ~ The Bhagavad Gita

Related:

CALL - Call one batch program from another.


CMD - Start a new DOS shell (cmd.exe)
IF - Test that required inputs are in place (not NULL)
FOR - Conditionally perform a command several times.
SETLOCAL - Control the visibility of environment variables
SHIFT - Shift the position of replaceable parameters in a batch file.
How Command Line Parameters are Parsed by David Deley
Bug when using ~s to display short file/folder names
StackOverflow - How does the Windows Command Interpreter (CMD.EXE) parse scripts?
Equivalent bash command (Linux): dirname - Convert a full pathname to just a path.

https://ss64.com/nt/syntax-args.html[8/24/2017 10:32:54 AM]


Parameters / Arguments - Windows CMD - SS64.com

Copyright © SS64.com 1999-2017


Some rights reserved

https://ss64.com/nt/syntax-args.html[8/24/2017 10:32:54 AM]


Start | Run Commands for Windows - Windows CMD - SS64.com

( SS64 ) CMD Syntax


Search

Windows Start | Run commands


Description Run Command
utilman
Accessibility Options or
control access.cpl

Add Hardware Wizard hdwwiz

Add/Remove Programs appwiz.cpl


(Add New Programs) control appwiz.cpl,,1
(Add Remove Windows Components) control appwiz.cpl,,2
(Set Program Access & Defaults ) control appwiz.cpl,,3

Administrative Tools control admintools

Advanced User Accounts Control Panel netplwiz

Authorization Manager azman.msc

Automatic Update control wuaucpl.cpl

Backup and Restore Utility sdclt

Bluetooth Transfer Wizard fsquirt

Calculator calc

Certificate Manager certmgr.msc

Character Map charmap

Check Disk Utility chkdsk

Clear Type (tune or turn off) cttune

Color Management colorcpl.exe

Command Prompt cmd

dcomcnfg
Component Services or
comexp.msc

CompMgmtLauncher.exe
Computer Management or
compmgmt.msc

Control Panel control

Credential (passwords) Backup and Restore Wizard credwiz

Data Execution Prevention SystemPropertiesDataExecutionPrevention

Date and Time Properties timedate.cpl

hdwwiz
Device Manager or
devmgmt.msc

Device Pairing Wizard DevicePairingWizard

https://ss64.com/nt/run.html[8/24/2017 10:33:04 AM]


Start | Run Commands for Windows - Windows CMD - SS64.com

Digitizer Calibration Tool (Tablets/Touch screens) tabcal

Direct X Control Panel (if installed) directx.cpl

Direct X Troubleshooter dxdiag

Disk Cleanup Utility cleanmgr

dfrgui
Disk Defragmenter
defrag

Disk Management diskmgmt.msc

Disk Partition Manager diskpart

Display Color Calibration dccw

Display DPI / Text size dpiscaling

Display Properties (Themes, Desktop, Screensaver) control desktop

Display Properties (Resolution, Orientation) desk.cpl

Display Properties (Color & Appearance) control color

Documents (open 'My Documents' folder) documents

Downloads (open 'Downloads' folder) downloads

Driver Verifier Utility verifier

DVD Player dvdplay

Edit Environment Variables rundll32.exe sysdm.cpl,EditEnvironmentVariables

Encrypting File System Wizard (EFS) rekeywiz

Event Viewer eventvwr.msc

File Signature Verification Tool (Device drivers) sigverif

Files and Settings Transfer Tool %systemroot%\system32\migwiz\migwiz.exe

Firewall Control Panel firewall.cpl

Folders Properties control folders

Fonts list control fonts

Font preview fontview arial.ttf

Game Controllers joy.cpl

Local Group Policy Editor gpedit.msc

Internet Properties inetcpl.cpl

IP Configuration ipconfig

iSCSI Initiator configuration iscsicpl

Keyboard Properties control keyboard

Language Pack Installer lpksetup

Local Security Policy secpol.msc

Local Users and Groups lusrmgr.msc

Log out logoff

https://ss64.com/nt/run.html[8/24/2017 10:33:04 AM]


Start | Run Commands for Windows - Windows CMD - SS64.com

Microsoft Malicious Software Removal Tool mrt

Microsoft Management Console mmc

Access (Microsoft Office) msaccess

Excel (Microsoft Office) Excel

Powerpoint (Microsoft Office) powerpnt

Word (Microsoft Office) winword

Microsoft Paint mspaint

Microsoft Support Diagnostic Tool msdt

control mouse
Mouse Properties or
main.cpl

control netconnections
Network Connections or
ncpa.cpl

Projector: netproj
Connect to Network Projector
Switch projector display displayswitch

Notepad notepad

ODBC Data Source Admin


Default ODBC driver: C:\windows\system32\odbcad32.exe
32-bit ODBC driver under 64-bit platform: C:\windows\sysWOW64\odbcad32.exe

ODBC configuration - Install/configure MDAC drivers odbcconf

On Screen Keyboard osk

OOB Getting Started gettingstarted

Password - Create a Windows Password Reset Disk "C:\Windows\system32\rundll32.exe"


(USB) keymgr.dll,PRShowSaveWizardExW

Pen and Touch (Tablet/Pen input configuration) tabletpc.cpl

Performance Monitor perfmon.msc

Phone and Modem Options telephon.cpl

Phone Dialer dialer

Power Configuration powercfg.cpl and powercfg.exe

Presentation Settings PresentationSettings

Problem Steps Recorder psr

Program Access and Computer Defaults - browser / email computerdefaults


/ media
Printers and Faxes control printers

Print Management (.msc) PrintManagement

Printer Migration (backup/restore) printbrmui and printbrm.exe

Printer user interface (List all printui.dll options) printui

https://ss64.com/nt/run.html[8/24/2017 10:33:04 AM]


Start | Run Commands for Windows - Windows CMD - SS64.com

Private Character Editor eudcedit

Regional Settings - Language, Date/Time format,


intl.cpl
keyboard locale.
Registry Editor regedit

Remote Assistance msra

Remote Desktop mstsc

Resource Monitor resmon

Resultant Set of Policy rsop.msc

Scheduled Tasks control schedtasks

Screenshot Snipping Tool snippingtool

Security Center wscui.cpl

Services services.msc

Shared Folder Wizard shrpubw

Shared Folders fsmgmt.msc

Shut Down Windows shutdown

Software Licensing/Activation slui

Sounds and Audio mmsys.cpl

Sound Recorder soundrecorder

Sound Volume sndvol

Syncronization Tool (Offline files) mobsync

System Configuration Utility msconfig

System File Checker Utility (Scan/Purge) sfc

System Information msinfo32

sysdm.cpl SystemProperties
System Properties or
sysdm.cpl DisplaySYSDMCPL

System Properties - Performance SystemPropertiesPerformance

System Properties - Hardware SystemPropertiesHardware

System Properties - Advanced SystemPropertiesAdvanced

System Repair - Create a System Repair Disc recdisc

System Restore rstrui

Task Manager taskmgr

Task Scheduler taskschd.msc

Telnet Client telnet

Trusted Platform Module Initialization Wizard tpmInit

control userpasswords2
User Accounts (Autologon)

https://ss64.com/nt/run.html[8/24/2017 10:33:04 AM]


Start | Run Commands for Windows - Windows CMD - SS64.com

User Account Control (UAC) Settings UserAccountControlSettings

C:\Windows\System32\rundll32.exe
User Profiles - Edit/Change type
sysdm.cpl,EditUserProfiles

Windows Disc Image Burning Tool isoburn C:\movies\madmax.iso

Windows Explorer explorer

Windows Features optionalfeatures

Windows Firewall firewall.cpl


Windows Firewall with Advanced Security wf.msc

Windows Image Acquisition (scanner) wiaacmgr

Windows Magnifier magnify

Windows Management Infrastructure wmimgmt.msc

Windows Memory Diagnostic Scheduler mdsched

Windows Mobility Center (Mobile PCs only) mblctr

Windows PowerShell powershell

Windows PowerShell ISE powershell_ise

Windows Security Action Center wscui.cpl

Windows Script Host(VBScript) wscript NAME_OF_SCRIPT.VBS

Windows System Security Tool. Encrypt the SAM


database. syskey
(boot password.)
Windows Update wuapp

Windows Update Standalone Installer wusa

Windows Version (About Windows) winver

WordPad write

Unless indicated otherwise, all the commands above work in all versions of Windows from Vista upwards.
Most of these utilities can be found in %systemroot%\System32\

“The Macintosh uses an experimental pointing device called a 'mouse.' There is no evidence that people want to use these things” ~ John
Dvorak

Related

MMC Snap-ins - Admin commands


Shell: folder - Shortcuts to key folders.
ProfileFolders - Location of user profile folders.
EXPLORER - Open Windows Explorer
Windows Key - Shortcuts

https://ss64.com/nt/run.html[8/24/2017 10:33:04 AM]


Start | Run Commands for Windows - Windows CMD - SS64.com

Copyright © SS64.com 1999-2017


Some rights reserved

https://ss64.com/nt/run.html[8/24/2017 10:33:04 AM]


MMC Admin command lines - Windows CMD - SS64.com

( SS64 ) CMD Syntax


Search

MMC Snap-ins
System Administrator command line shortcuts to popular Microsoft Management Consoles (MMCs).

Admin Snap-in Command Category


Quality of Service Control Management ACSsnap.msc Network
ADSI Edit ADSIedit.msc AD Configuration
Authorization manager AZman.msc Security
Certificates Management - Local machine Certlm.msc Security
Certificates Management - Current user Certmgr.msc Security
Certification Authority Management Certsrv.msc Security
Certificate Templates Certtmpl.msc Security
Failover cluster Manager Cluadmin.exe Disc, File
Component Services Comexp.msc

Computer Management Compmgmt.msc

Device Manager Devmgmt.msc Hardware


Notifications/Start menu/policy DevModeRunAsUserConfig.msc

Disk Defragmenter Defrag.exe (formerly Dfrg.msc) Disc, File


Distributed File Service Mgmt DFSmgmt.msc Disc, File
Disk Manager DiskMgmt.msc Disc, File
DNS Manager DNSmgmt.msc Network
AD Domains and Trusts Domain.msc AD Configuration
AD Users and Computers DSA.msc Security
AD Sites and Services DSsite.msc AD Configuration
Embedded Lockdown Manager EmbeddedLockdown.msc Security
Event Viewer Eventvwr.msc

Shared Folders open files FSmgmt.msc Disc, File


File Server Resource manager FSRM.msc Disc, File
Local Group Policy Editor GPedit.msc Policy
Group Policy Management GPmc.msc Policy
Group Policy Management Editor GPme.msc Policy
Group Policy Starter GPO Editor GPTedit.msc Policy
Local Users and Groups Manager LUsrMgr.msc Security
Teminal Services RDP MSTSC Remote Access
Teminal Services RDP to Console MSTSC /v:[server] /console Remote Access

https://ss64.com/nt/syntax-mmc.html[8/24/2017 10:33:14 AM]


MMC Admin command lines - Windows CMD - SS64.com

NAP client configuration NapCLCfg Network


Performance Monitor PerfMon.msc

Print Management PrintManagement.msc Print


Resultant Set of Policy RSOP.msc Policy
Local Security Settings Manager SecPol.msc Policy
Server Roles, Features ServerManager.msc

Services Management Services.msc

SQL Server configuration Manager SQLServerManager11.msc

Storage Mgmt StorageMgmt.msc Disc, File


Telephony Management TAPImgmt.msc Phone/Modem
Task Scheduler TaskSchd.msc

Trusted Platform Module TPM.msc Security


Terminal Server Manager TSadmin.exe Remote Access
Remote Desktop TSmmc.msc Remote Access
Windows Mangement Instrumentation WmiMgmt.msc

Windows Server Backup (Local+Remote) WBadmin.msc Disc, File


Windows Local Backup WLBadmin.msc Disc, File
Windows Firewall WF.msc Remote Access

The commands above can be entered from START > Run, or from the command line.
Availability will vary by OS and by the features installed.

“I don't do anything in order to cause trouble. It just so happens that what I do naturally causes trouble.
I'm proud to be a troublemaker” ~ Sinead O'Connor

Related:

Run Commands

Copyright © SS64.com 1999-2017


Some rights reserved

https://ss64.com/nt/syntax-mmc.html[8/24/2017 10:33:14 AM]


Shell folder shortcuts - Windows CMD - SS64.com

( SS64 ) CMD Syntax


Search

Shell: folder shortcuts


Roaming?
Description Shell: folder shortcut Type

Display installed Windows Updates shell:AppUpdatesFolder System folder


Display links provided by your PC manufacturer (if
shell:OEM Links System folder
any)
Open the Computer folder shell:MyComputerFolder System folder
Open the folder holding all user profiles shell:UserProfiles System folder
Open the Fonts folder shell:Fonts System folder
Open the Games folder shell:Games System folder
Open the HomeGroup folder shell:HomeGroupFolder System folder
Open the HomeGroup folder for the currently logged-
shell:HomeGroupCurrentUserFolder System folder
on user (if any)
Open the Network Places folder shell:NetworkPlacesFolder System folder
Open the Printers folder shell:PrintersFolder System folder
Open the Public Application Data folder shell:Common AppData System folder
Open the Public Desktop shell:Common Desktop System folder
Open the Public Documents folder shell:Common Documents System folder
Open the Public Downloads folder shell:CommonDownloads System folder
Open the Public Game Explorer folder shell:PublicGameTasks System folder
Open the Public ringtones folder. shell:CommonRingtones System folder
Open the Public Start Menu folder shell:Common Start Menu System folder
Open the Public Start Menu Programs folder shell:Common Programs System folder
Open the Public Startup folder shell:Common Startup System folder
Open the Public Templates folder shell:Common Templates System folder
Open the Recycle Bin shell:RecycleBinFolder System folder
Open the Users\Public folder (Shared files) shell:Public System folder
Open the Windows installation folder (usually
shell:Windows System folder
\Windows)
Open the Windows Resources folder (themes are shell:ResourceDir System folder
stored here)
Open the Windows System folder shell:System System folder
Open the Windows System folder for 32-bit files on
64-bit Windows, shell:Systemx86 System folder
Or \Windows\System32 on 32-bit Windows
Access shortcuts pinned to the Start menu or Taskbar shell:User Pinned User folder Y

https://ss64.com/nt/shell.html[8/24/2017 10:33:23 AM]


Shell folder shortcuts - Windows CMD - SS64.com

Display the user's Ringtones folder shell:Ringtones User folder


Display further user tiles shell:Roaming Tiles User folder Y
Display your user tiles (the images you can use for
shell:UserTiles User folder
your account)
Open the Client Side Cache Offline Files folder, if
shell:CSCFolder User folder
supported
Open the folder where files are stored before being
shell:CD Burning User folder
burned to disc
Open the Public user tiles folder shell:PublicUserTiles User folder
Open the Quick Launch folder (disabled by default) shell:Quick Launch User folder Y
Open the Saved Games folder shell:SavedGames User folder Y
Open the saved searches folder shell:Searches User folder Y
Open the user‘s \Music\Playlists folder shell:Playlists User folder Y
Open the user‘s Application Data folder shell:AppData User folder Y
Open the user‘s Application Data folder (same as
shell:Local AppData User folder
% LOCALAPPDATA%)

Open the user‘s certificates folder shell:SystemCertificates User folder Y


Open the user‘s Credentials folder shell:CredentialManager User folder Y
Open the user‘s desktop folder shell:Desktop User folder Y
Open the user‘s Documents folder shell:Personal User folder Y
Open the user‘s downloads folder shell:Downloads User folder Y
Open the user‘s encryption keys folder shell:Cryptokeys User folder Y
Open the user‘s Game Explorer folder shell:GameTasks User folder
Open the user‘s History folder shell:History User folder
Open the user‘s Links folder shell:Links User folder Y
Open the user‘s Network Places folder shell:NetHood User folder Y
Open the user‘s printer shortcuts folder shell:PrintHood User folder Y
Open the user‘s profile folder (same as
shell:Profile User folder Y
% USERPROFILE%)

Open the user‘s Send To folder shell:SendTo User folder Y


Open the user‘s Start Menu folder shell:Start Menu User folder Y
Open the user‘s Start Menu Programs folder shell:Programs User folder Y
Open the user‘s Startup folder shell:Startup User folder Y
Open the user‘s Templates folder shell:Templates User folder Y
Open the user‘s Windows Contacts folder shell:Contacts User folder Y
Open the user‘s Recent Documents folder shell:Recent User folder Y
Opens the user‘s AppData\Roaming\Microsoft\Protect
shell:DpAPIKeys User folder Y
folder
Display 32-bit programs stored on 64-bit Windows, Internet

https://ss64.com/nt/shell.html[8/24/2017 10:33:23 AM]


Shell folder shortcuts - Windows CMD - SS64.com

shell:ProgramFilesX86
or the \Program Files folder on 32-bit Windows Explorer
Internet
Display the Control Panel shell:ControlPanelFolder
Explorer
Open the user‘s Start Menu\Administrative Tools Internet
shell:Administrative Tools Y
folder (if any) Explorer
shell:Immersive Application Internet
Display Metro App shortcuts (Windows 8) Shortcuts Explorer
shell:Common Administrative Internet
Open All Users Start Menu\Administrative Tools folder
Tools Explorer
Internet
Launches Internet Explorer Applets and applications shell:InternetFolder
Explorer
Open the Common Files for 32-bit programs stored on
64-bit Windows, Internet
shell:ProgramFilesCommonX86
Or the Program Files\Common Files folder on 32-bit Explorer
Windows
Open the Control Panel "Install a program from the shell:AddNewProgramsFolder
Internet
network" applet Explorer
Open the Control Panel "Uninstall or change a Internet
shell:ChangeRemoveProgramsFolder
program" applet Explorer
Internet
Open the default Sidebar Gadgets folder shell:Default Gadgets
Explorer
Internet
Open the hidden ImplicitAppShortcuts folder shell:ImplicitAppShortcuts Y
Explorer
Internet
Open the Internet Explorer Cookies folder shell:Cookies Y
Explorer
Internet
Open the Internet Explorer Favorites folder shell:Favorites Y
Explorer
Internet
Open the list of Network Connections shell:ConnectionsFolder
Explorer
Open the Program Files folder (same as Internet
shell:ProgramFiles
% PROGRAMFILES%) Explorer
Internet
Open the Program Files\Common Files folder shell:ProgramFilesCommon
Explorer
Internet
Open the Temporary Internet Files folder shell:Cache
Explorer
Internet
Open the user folder of downloaded Sidebar Gadgets shell:Gadgets
Explorer
Internet
Open the Windows Search tool shell:SearchHomeFolder
Explorer
Display public libraries, if any shell:PublicLibraries Library
Display your Music library shell:MusicLibrary Library
Display your Pictures library shell:PicturesLibrary Library
Display your Videos library shell:VideosLibrary Library
Open the Documents library shell:DocumentsLibrary Library

https://ss64.com/nt/shell.html[8/24/2017 10:33:23 AM]


Shell folder shortcuts - Windows CMD - SS64.com

Open the Libraries folder shell:Libraries Library


Open the Windows Photo Gallery Original Images
shell:Original Images Multimedia
folder, if installed
Open the Public Music folder shell:CommonMusic Multimedia
Open the Public Pictures folder shell:CommonPictures Multimedia
Open the Public Video folder shell:CommonVideo Multimedia
Open the Sample Music folder shell:SampleMusic Multimedia
Open the Sample Pictures folder shell:SamplePictures Multimedia
Open the Sample Videos folder shell:SampleVideos Multimedia
Open the user‘s Music folder shell:My Music Multimedia Y
Open the user‘s Pictures folder shell:My Pictures Multimedia Y
Open the user‘s Pictures\Slide Shows folder (if
shell:PhotoAlbums Multimedia Y
present)
Open the user‘s Videos folder shell:My Video Multimedia Y
Windows Sync
Display Sync Centre shell:SyncCenterFolder
Centre
Windows Sync
Display Sync Centre Conflicts shell:ConflictFolder
Centre
Windows Sync
Display Sync Centre Results shell:SyncResultsFolder
Centre
Windows Sync
Open the Sync Centre Setup options shell:SyncSetupFolder
Centre

Unless indicated otherwise, all the shortcuts above work in all versions of Windows from Vista upwards.

Shell folder shortcuts can be used directly in the Windows Explorer Address bar: shell:Desktop

Or in the Start Menu Start | Run | shell:Desktop

Or from the command line:


C:\> explorer shell:desktop
C:\> start shell:desktop

The START command does also accept Shell shortcuts with spaces but they have to be quoted like so:
C:\> start "" "shell:my music "

“You go away for a long time and return a different person - you never come all the way back” ~ Paul Theroux

Related

EXPLORER - Open Windows Explorer


ProfileFolders - Location of user profile folders.
Env. Variables - List of environment variables.
RUN commands Start | Run commands.

https://ss64.com/nt/shell.html[8/24/2017 10:33:23 AM]


Shell folder shortcuts - Windows CMD - SS64.com

Copyright © SS64.com 1999-2017


Some rights reserved

https://ss64.com/nt/shell.html[8/24/2017 10:33:23 AM]


User Shell Folders - Windows CMD - SS64.com

( SS64 ) CMD Syntax


Search

User Shell Folders - Profile, Start Menu folder...


In Windows 7/2008 the main User Profile folder ( %USERPROFILE% ) has moved from C:\Documents and Settings\ to C:\Users\
and many profile folders have also changed name or location:
Windows XP/2003 Windows 7/2008
%USERPROFILE%\Application Data %USERPROFILE%\AppData\Roaming
%USERPROFILE%\Cookies %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Cookies
%USERPROFILE%\History %USERPROFILE%\AppData\Local\Microsoft\Windows\History
%USERPROFILE%\Local Settings %USERPROFILE%\AppData\Local
%USERPROFILE%\My Documents %USERPROFILE%\Documents
%USERPROFILE%\NetHood %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Network Shortcuts
%USERPROFILE%\PrintHood %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Printer Shortcuts
%USERPROFILE%\Recent %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Recent
%USERPROFILE%\SendTo %USERPROFILE%\AppData\Roaming\Microsoft\Windows\SendTo
%USERPROFILE%\Start Menu %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Start Menu
%USERPROFILE%\Templates %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Templates
%USERPROFILE%\Temporary Internet Files %USERPROFILE%\AppData\Local\Microsoft\Windows\Temporary Internet Files
Windows XP/2003 Windows 10/2012 R2
%USERPROFILE%\Application Data %USERPROFILE%\AppData\Roaming
%USERPROFILE%\Cookies %USERPROFILE%\AppData\Local\Microsoft\Windows\INetCookies
%USERPROFILE%\History %USERPROFILE%\AppData\Local\Microsoft\Windows\History
%USERPROFILE%\Local Settings %USERPROFILE%\AppData\Local
%USERPROFILE%\My Documents %USERPROFILE%\Documents
%USERPROFILE%\NetHood %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Network Shortcuts
%USERPROFILE%\PrintHood %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Printer Shortcuts
%USERPROFILE%\Recent %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Recent Items
%USERPROFILE%\SendTo %USERPROFILE%\AppData\Roaming\Microsoft\Windows\SendTo
%USERPROFILE%\Start Menu %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Start Menu
%USERPROFILE%\Templates %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Templates
%USERPROFILE%\Temporary Internet Files %USERPROFILE%\AppData\Local\Microsoft\Windows\INetCache

The values above can be found in the registry (as REG_EXPAND_SZ values)
HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders

The following HKCU registry subkeys are common to Windows XP/2003/7/2008 :


AppData, Cache, Cookies, Desktop, Favorites, History, LocalAppData, My Pictures, NetHood, Personal, PrintHood,
Programs, Recent, SendTo, Start Menu, Startup, Templates.

By default these all resolve to subfolders below %USERPROFILE% but they can be redirected to other locations.
The registry locations are always the same, but the files and folders may be in different places.

To provide backwards compatibility, in Windows 7 and above the old locations under C:\Documents and Settings contain
junction points (hidden, protected operating system files) which point to the new user-accessible folders.

'All Users' Shell Folders


The folders for All Users settings have also moved:
Windows XP/2003 Windows 7/2008
%ALLUSERSPROFILE%\Application Data %ProgramData%
%ALLUSERSPROFILE%\Desktop %PUBLIC%\Desktop
%ALLUSERSPROFILE%\Documents %PUBLIC%\Documents
%ALLUSERSPROFILE%\Start Menu\Programs %ProgramData%\Microsoft\Windows\Start Menu\Programs
%ALLUSERSPROFILE%\Start menu %ProgramData%\Microsoft\Windows\Start Menu
%ALLUSERSPROFILE%\Start Menu\Programs\Startup %ProgramData%\Microsoft\Windows\Start
Menu\Programs\Startup
%ALLUSERSPROFILE%\Templates %ProgramData%\Microsoft\Windows\Templates
Windows XP/2003 Windows 10/2012 R2
%ALLUSERSPROFILE%\Application Data %ProgramData%
%ALLUSERSPROFILE%\Desktop %PUBLIC%\Public Desktop
%ALLUSERSPROFILE%\Documents %PUBLIC%\Public Documents
%ALLUSERSPROFILE%\Start Menu\Programs %ProgramData%\Microsoft\Windows\Start Menu\Programs *
%ALLUSERSPROFILE%\Start menu %ProgramData%\Microsoft\Windows\Start Menu *
%ALLUSERSPROFILE%\Start Menu\Programs\Startup %ProgramData%\Microsoft\Windows\Start
Menu\Programs\Startup *
%ALLUSERSPROFILE%\Templates %ProgramData%\Microsoft\Windows\Templates

https://ss64.com/nt/syntax-folders.html[8/24/2017 10:33:33 AM]


User Shell Folders - Windows CMD - SS64.com

* In Windows 10 the Start Menu items are held in a database that is stored under
C:\Users\accountname\AppData\Local\TileDataLayer this is proprietary, non user editable and limited to 500
shortcuts. It is also used for Cortana Search. The entire database can be copied between accounts - all or nothing.

The values above can be found in the registry (as REG_EXPAND_SZ values)
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders
The entries in this subkey can appear in both the Shell Folders subkey and the User Shell Folders and in both
HKLM and HKCU. The entries that appear in User Shell Folders take precedence over those in Shell Folders.
The entries that appear in HKCU take precedence over those in HKLM

The following HKLM registry subkeys are common to Windows XP/2003/7/2008 :


Common AppData, Common Desktop, Common Documents, Common Programs, Common Start Menu, Common Startup,
Common templates

Folder Redirection
Although it is possible to redirect any of these folders with Group Policy, not all options are fully supported,
for example redirecting IE favorites/cookies will result in very slow performance.

Examples

Find the location of the Start Menu folder:


For /f "tokens=3*" %%G in ('REG QUERY "HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell
Folders" /v "Start Menu" ^|Find "REG_"') do Call Set _startmenu=%%H

Echo %_startmenu%

PowerShell function to open the Start menu:


function Open-StartMenu {
$drive = dir env:SystemDrive
$w7path = $drive.value + "\ProgramData\Microsoft\Windows\Start Menu"
$xppath = $drive.value + "\Documents and Settings\All Users\Start Menu"
if (test-path $w7path)
{explorer $w7path}
elseif (test-path $xppath) {explorer $xppath}
}

“There are no shortcuts to any place worth going” - Beverly Sills

Related:

Shell: folder - Shortcuts to key folders.


Windows Environment Variables
RoamingProfile.vbs - Cleardown files to improve logon and logoff times.
Managing Roaming User Data Deployment Guide - TechNet (html and .doc)
Q886549 - User Shell Folders

https://ss64.com/nt/syntax-folders.html[8/24/2017 10:33:33 AM]


User Shell Folders - Windows CMD - SS64.com

Copyright © SS64.com 1999-2017


Some rights reserved

https://ss64.com/nt/syntax-folders.html[8/24/2017 10:33:33 AM]


Windows Environment Variables - Windows CMD - SS64.com

( SS64 ) CMD Syntax


Search

Windows Environment Variables


Environment variables are mainly used within batch files, they can be created, modified and deleted for a session using the
SET command. To make permanent changes, use SETX

Variables can be displayed using either SET or ECHO.

Variables have a percent sign on both sides: %ThisIsAVariable%


The variable name can include spaces, punctuation and mixed case: %_Another Ex.ample%
(This is unlike Parameter variables which only have one % sign and are always one character long: %A )

A variable name may include any of the following characters:


A-Z, a-z, 0-9, # $ ' ( ) * + , - . ? @ [ ] _ ` { } ~

Array variables
Unlike PowerShell, which fully supports arrays, there is no built in support for array variables within the CMD shell.
However with some effort you can replicate this functionality using a series of separate variables, named to
represent the array:
Set elem[1]=First element
Set elem[2]=Second one
Set elem[3]=The third one

To perform array indexing operations with these, use EnableDelayedExpansion and a reference like
!elem[%var%]!
this is explained fully in this StackOverflow Q/A.

Standard (built-in) Environment Variables


Volatile
Default value in Windows 7/10/2008 (assuming the system drive is C:
Variable (Read-
)
Only)
ALLUSERSPROFILE C:\ProgramData
APPDATA C:\Users\{username}\AppData\Roaming
CD Y The current directory (string).

ClientName Y Terminal servers only - the ComputerName of a remote host.

The current Command Processor Extensions version number. (NT = "1",


CMDEXTVERSION Y
Win2000+ = "2".)
CMDCMDLINE Y The original command line that invoked the Command Processor.
CommonProgramFiles C:\Program Files\Common Files
COMMONPROGRAMFILES(x86) C:\Program Files (x86)\Common Files
COMPUTERNAME {computername}

COMSPEC
C:\Windows\System32\cmd.exe or if running a 32 bit WOW -
C:\Windows\SysWOW64\cmd.exe
DATE Y The current date using same region specific format as DATE.

The current ERRORLEVEL value, automatically set when a program


ERRORLEVEL Y
exits.

FPS_BROWSER_APP_PROFILE_STRING
Internet Explorer

https://ss64.com/nt/syntax-variables.html[8/24/2017 10:33:42 AM]


Windows Environment Variables - Windows CMD - SS64.com

Default
FPS_BROWSER_USER_PROFILE_STRING
These are undocumented variables for the Edge browser in Windows
10.
Y
HighestNumaNodeNumber The highest NUMA node number on this computer.
(hidden)
HOMEDRIVE Y C:
HOMEPATH Y \Users\{username}
LOCALAPPDATA C:\Users\{username}\AppData\Local
LOGONSERVER \\{domain_logon_server}
NUMBER_OF_PROCESSORS Y The Number of processors running on the machine.

OS Y Operating system on the user's workstation.

User
C:\Windows\System32\;C:\Windows\;C:\Windows\System32\Wbem;{plus
PATH and
program paths}
System
.COM; .EXE; .BAT; .CMD; .VBS; .VBE; .JS ; .WSF; .WSH; .MSC
PATHEXT
The syntax is like the PATH variable - semicolon separators.
AMD64/IA64/x86 This doesn't tell you the architecture of the processor
PROCESSOR_ARCHITECTURE Y but only of the current process, so it returns "x86" for a 32 bit WOW
process running on 64 bit Windows. See detecting OS 32/64 bit
PROCESSOR_ARCHITEW6432 = %ProgramFiles% (only available on 64 bit systems)

PROCESSOR_IDENTIFIER Y Processor ID of the user's workstation.

PROCESSOR_LEVEL Y Processor level of the user's workstation.

PROCESSOR_REVISION Y Processor version of the user's workstation.


ProgramW6432 = %PROCESSOR_ARCHITECTURE% (only available on 64 bit systems)
ProgramData C:\ProgramData
ProgramFiles C:\Program Files or C:\Program Files (x86)

ProgramFiles(x86) 1 C:\Program Files (x86)

PROMPT
Code for current command prompt format,usually $P$G
C:>

PSModulePath %SystemRoot%\system32\WindowsPowerShell\v1.0\Modules\
Public C:\Users\Public
RANDOM Y A random integer number, anything from 0 to 32,767 (inclusive).
Terminal servers only - for a terminal server session, SessionName is a
%SessionName% combination of the connection name, followed by #SessionNumber. For
a console session, SessionName returns "Console".
SYSTEMDRIVE C:
By default, Windows is installed to C:\Windows but there's no guarantee
of that, Windows can be installed to a different folder, or a different drive
letter.
SYSTEMROOT
systemroot is a read-only system variable that will resolve to the correct
location.
NT 4.0, Windows 2000 and Windows NT 3.1 default to C:\WINNT

https://ss64.com/nt/syntax-variables.html[8/24/2017 10:33:42 AM]


Windows Environment Variables - Windows CMD - SS64.com

User C:\Users\{Username}\AppData\Local\Temp
TEMP and TMP
Variable Under XP this was \{username}\Local Settings\Temp
TIME Y The current time using same format as TIME.

Y
Set if a user is a logged on to a domain and returns the fully qualified
UserDnsDomain User
DNS domain that the currently logged on user's account belongs to.
Variable
USERDOMAIN {userdomain}

USERDOMAIN_roamingprofile
The user domain for RDS or standard roaming profile paths. Windows
8/10/2012 (or Windows 7/2008 with Q2664408)
USERNAME {username}

USERPROFILE
%SystemDrive%\Users\{username}
This is equivalent to the $HOME environment variable in Unix/Linux

%WinDir% pre-dates Windows NT and seems to be superseded by


%SystemRoot%
WINDIR Set by default as windir=%SystemRoot%
%windir% is a regular variable and can be changed, which makes it less
robust than %systemroot%

1 Only on 64 bit systems, is used to store 32 bit programs.

Unless stated otherwise, all the variables above are System variables

Environment variables are stored in the registry:

User Variables: HKEY_CURRENT_USER\Environment


System Variables: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment

By default, files stored under Local Settings do not roam with a roaming profile.

Dynamic environment variables are read-only and are computed each time the variable is expanded. When all variables are
listed with SET, these will not appear in the list. Do not attempt to directly SET a dynamic variable.

Undocumented Dynamic variables (read only)


%__APPDIR__% The directory path to the current application .exe, terminated with a trailing backslash. (Global) -
discuss
%__CD__% The current directory, terminated with a trailing backslash. (Global)
%=C:% The current directory of the C: drive.
%=D:% The current directory of the D: drive if drive D: has been accessed in the current CMD session.
%DPATH% Related to the (deprecated) DPATH command.
%=ExitCode% The most recent exit code returned by an external command, such as CMD /C EXIT n, converted to
hex.
%=ExitCodeAscii% The most recent exit code returned by an external command, as ASCII. (Values 0-32 do not
display because those map to ASCII control codes.)
%FIRMWARE_TYPE% The boot type of the system: Legacy ,UEFI,Not implemented ,Unknown Windows 8/2012.
%KEYS% Related to the (deprecated) KEYS command.
More detail on these undocumented variables can be found in this stackoverflow answer from Dave Benham.

Undocumented Dynamic variables (read/write)


%__COMPAT_LAYER% Set the ExecutionLevel to either RunAsInvoker (asInvoker), RunAsHighest (highestAvailable) or
RunAsAdmin (requireAdministrator) for more see elevation and Q286705 / Application Compatibility Toolkit for other
Compatibility Layers (colours,themes etc).

https://ss64.com/nt/syntax-variables.html[8/24/2017 10:33:42 AM]


Windows Environment Variables - Windows CMD - SS64.com

Pass variables between batch scripts


There are several ways to pass values between batch files, or between a batch file and the command line, see the
CALL and SETLOCAL pages for full details.

A child process by default inherits a copy of all environment variables from its parent, this makes environment
variables unsuitable for storing secret information such as API keys or user passwords, especially in rare
occasions like crashes where a crash log will often include the full OS environment at the time of the crash.
PowerShell/Get-Credential is a more secure approach.

“Men may be convinced, but they cannot be pleased against their will. But though taste is obstinate, it is very variable, and time often
prevails when arguments have failed” ~ Samuel Johnson

Related:

PowerShell - Working with Environment variables


User Shell Folders - Standard folder locations.
Detecting 32 vs 64 bit Windows
CALL - Evaluate environment variables
SET - View environment variables, set local variables
SETX - Set environment variables
Q100843 - The four types of environment variable
Q286705 - Set compatibility variables
Q242557 - Registry Settings for Folder Redirection
StackOverflow - Storing a Newline in a variable
Managing Roaming User Data Deployment Guide - Microsoft.com (Word Doc)

Copyright © SS64.com 1999-2017


Some rights reserved

https://ss64.com/nt/syntax-variables.html[8/24/2017 10:33:42 AM]


Another random document with
no related content on Scribd:
Narbonne fut livrée à Théodoric par un traître, et Ægidius, réfugié
dans la vallée de la Loire, y fut pourchassé par le prince Frédéric.
Celui-ci succomba peu de temps après dans la lutte, débarrassant
son frère d'un rival plutôt qu'il ne le privait d'un appui. La mort
d'Ægidius, survenue peu après, livra toute l'Aquitaine au roi barbare.
Le portrait que nous trace de celui-ci une plume romaine éveille
l'idée d'une force royale pleine de modération et d'activité, qui se
possède elle-même au milieu de la toute-puissance. La journée de
Théodoric, commencée par des pratiques de piété, se continue par
les graves occupations de la politique, parmi lesquelles se place
surtout la réception des ambassadeurs étrangers. Les distractions
du roi consistent à passer en revue son trésor ou à visiter ses
écuries; souvent aussi il goûte le plaisir de la chasse. Ses repas sont
simples, même les jours de fête; après le dîner, le roi prend un léger
somme; parfois il joue, et il s'amuse de la mauvaise humeur de son
adversaire perdant. Le reste de la journée est de nouveau consacré
aux affaires. Le soir, le repas est égayé par quelque chantre
mélodieux ou par les saillies d'un bouffon, mais tout se passe avec
mesure, et sans rien de blessant pour aucun convive[44].
[44] Sidoine Apollinaire, Epist., i, 2.
Ce puissant, toutefois, ne devait pas vieillir en paix au milieu de sa
prospérité. Il avait inauguré ce qu'un écrivain franc appelle la
détestable coutume qu'ont les Goths de tuer leurs souverains[45].
Mais, de même qu'un fratricide l'avait fait monter sur le trône, un
fratricide l'en précipita, et il périt à la fleur de l'âge sous les coups de
son frère Euric.
[45] Grégoire de Tours, iii, 30.
Alors commença la carrière conquérante du plus remarquable des
rois visigoths. Devenu maître du pouvoir, il fit oublier à son peuple le
crime qui le lui avait valu, et il y déploya l'ardente activité et
l'ambition insatiable d'un génie dont la vocation est de commander.
En face de l'empire d'Occident qui faisait, sous Anthémius, de
languissants efforts pour remonter la pente fatale des choses, le
Mars de la Garonne, comme l'appelait Sidoine[46], s'affirma avec une
égale puissance comme diplomate et comme homme de guerre. Il
ouvrit des négociations avec les Suèves d'Espagne, avec les
Vandales d'Afrique, et entretint des intelligences avec cette partie de
la population romaine qui avait pris son parti d'une occupation
barbare, et aimait mieux la préparer que la subir. Rome, qui n'avait
plus d'armée et plus de généraux, combattait ses ennemis les uns
par les autres: aux Visigoths envahissants elle opposa les
Burgondes, qui vinrent tenir garnison à Clermont; les Bretons, qu'elle
campa au nombre de douze mille au cœur du Berry; les Francs, qui
avaient servi sous les ordres d'Ægidius, et qui étaient restés fidèles
à son successeur.
[46] Sidoine Apollinaire, Epist., viii, 9.
Mais rien n'arrêtait Euric. Tenu au courant, par des traîtres comme
Seronatus, de ce qui se passait du côté romain, il allait écraser les
Bretons à Déols (468), et, après cette journée qui lui rouvrait la
vallée de la Loire, il venait mettre le siège devant Clermont (473), qui
était, dans les montagnes, la clef de toutes les positions qui
commandent la Gaule centrale. Maître de ce poste, il pouvait se
porter à tour de rôle, selon les intérêts du moment, sur la Loire ou
sur le Rhône, et tenir en échec les Francs, les Burgondes et les
Romains d'Italie.
La patrie de Vercingétorix fit preuve alors, envers l'Empire agonisant,
de cette fidélité qu'elle avait montrée, il y avait cinq siècles, à la
liberté gauloise, comme s'il avait été dans sa destinée de s'honorer
en faisant briller sur les causes déchues un dernier rayon de gloire
et de dévouement. Seule en face d'un ennemi devant qui pliaient
toutes les résistances, abandonnée par l'Empire qui ne défendait
plus que l'Italie, par les Burgondes que l'heure du danger ne trouva
plus dans ses murs[47], la vaillante cité soutint bravement le choc. A
la tête de la résistance était son évêque, Sidoine Apollinaire, dans
lequel l'ordination épiscopale semblait avoir créé un pasteur de
peuples et un patriote, à côté du grand seigneur ami de la vie
mondaine et du faiseur de petits vers élégants. Cet homme, qui s'est
complu, au cours de ses écrits, dans une loquacité souvent si
fatigante, ne nous dit rien du rôle qu'il a joué dans ce siège, comme
si la grandeur à laquelle il dut élever son âme dans ces jours de
crise nationale n'était pas compatible avec le frivole babillage qui
était le caractère de son talent. Mais, s'il s'est oublié lui-même, il a
tracé dans une page inoubliable les services qu'un autre, qui lui était
cher, a rendus alors à l'Auvergne et à l'Empire. Cet autre, c'était son
beau-frère Ecdicius, fils de l'empereur Avitus, dont Sidoine avait
épousé la fille.
[47] Dahn, Die Kœnige der Germanen, V. p. 92, croit à tort que les Burgondes y
étaient encore; il n'y en a aucune preuve.
Ecdicius était une âme généreuse et grande, que la richesse n'avait
pas amollie, et qui avait gardé toute sa fermeté au milieu de
l'universel fléchissement des caractères de cette époque. Aux
premières nouvelles du danger qui menaçait sa patrie, il quitta
Rome, où l'avaient appelé les intérêts de sa province, et s'élança sur
la route de la Gaule. Brûlant les étapes, dévoré d'ardeur et
d'inquiétude, il déboucha enfin, à la tête de dix-huit cavaliers qui
formaient toute son escorte, dans le vaste bassin de la Limagne,
ayant en face de lui, sur la colline, les murailles aimées de la ville
natale, et, entre lui et elle, le camp des Visigoths. Il le traverse au
galop, se frayant un chemin à la pointe de l'épée, au milieu d'une
armée stupéfaite d'une audace qui semblait de la folie, et il parvient
à rentrer dans la ville sans avoir perdu un seul homme. La
population de Clermont, qui du haut de ses remparts avait assisté au
magnifique exploit de son concitoyen, lui fit une ovation
indescriptible. A travers les rues noires de monde, les cris de joie,
les sanglots et les applaudissements retentissaient sans
discontinuer, et il eut plus de peine à traverser cette multitude
désarmée que tout à l'heure à fendre les rangs des ennemis.
Chacun voulait le voir, le toucher, baiser ses mains ou ses genoux,
l'aider à détacher son armure; on comptait les coups dont sa cotte
de mailles portait les traces, on emportait comme des reliques la
poussière glorieuse qui couvrait ses habits, mêlée à la sueur et au
sang. Reconduit jusqu'auprès de son foyer par cette foule en délire
qui le bénissait avec des larmes, le héros savoura pleinement, en
une heure, l'ivresse de la reconnaissance populaire et la joie d'une
récompense si haute qu'elle semblait le salaire anticipé de la mort.
Cette incomparable journée avait exalté tous les cœurs: désormais
la défense eut l'entrain et l'enthousiasme d'une attaque. Avec ses
propres ressources, Ecdicius leva un corps de soldats à la tête
desquels il harcela l'ennemi par une série de sorties heureuses. Les
barbares, transformés presque en assiégés, eurent toutes les peines
du monde à maintenir leurs positions. Les pertes qu'ils faisaient
dans les rencontres quotidiennes étaient telles qu'ils se voyaient
obligés, pour n'en pas laisser reconnaître l'étendue, de couper les
têtes des morts; après quoi ils brûlaient les cadavres, sans aucune
solennité, dans des huttes où ils les entassaient[48]. Le courage des
assiégés ne se démentit pas: ils endurèrent les souffrances de la
faim sans parler de se rendre, et lorsque les provisions
commencèrent à s'épuiser, ils allèrent jusqu'à se nourrir des herbes
qui poussaient dans les interstices de leurs murailles[49]. Ce furent
les assiégeants qui perdirent patience: démoralisés par les exploits
d'Ecdicius, fatigués d'une lutte qui se prolongeait sans mesure,
effrayés de l'hiver qui s'avançait avec toutes ses rigueurs, ils
levèrent le siège, et Euric repartit avec l'humiliation d'avoir été arrêté
par une seule ville.
[48] Sidoine Apollinaire, Epist., iii, 3.
[49] Id., Epist., vii, 7.
Les souffrances de l'Auvergne n'étaient pas finies, car les Goths
avaient ravagé cruellement les campagnes des environs, et ils
laissaient derrière eux la famine, qui continuait leur œuvre de mort.
Alors le rôle de la charité commença. Sidoine Apollinaire se
multiplia; plus d'une fois, à l'insu de sa femme, il distribuait aux
pauvres l'argenterie de sa maison, qu'elle allait racheter ensuite[50].
Les évêques des cités voisines vinrent aussi au secours des
victimes. Tous les chemins de la province étaient sillonnés par les
voitures chargées des provisions envoyées par saint Patient, le
généreux évêque de Lyon[51]. Cette fois encore, Ecdicius ne
manqua pas à sa patrie: il fut aussi prodigue de son or que de son
sang, et à lui seul il nourrit sous son toit quatre mille affamés[52].
Mais la malédiction des décadences, c'est que l'héroïsme y est
stérile, et qu'elles ne savent que faire des plus généreux
dévouements. Les Arvernes croyaient avoir prouvé au monde qu'ils
avaient le droit de garder leur indépendance: ils furent trahis par
celui-là même qui avait pour devoir de les défendre. Comme les
Visigoths ne cessaient de troubler l'Empire, menaçant les autres
provinces si on leur cédait celle qui les avait repoussés, un
malheureux du nom de Julius Nepos, alors revêtu du titre impérial,
eut le triste courage de leur livrer cette noble contrée (475). On
devine le désespoir des patriotes arvernes. Ceux qui ne pouvaient
se résigner à cesser d'être Romains durent prendre le chemin de
l'exil. Ecdicius, on le comprend, fut du nombre; il alla, loin des murs
chéris dont il avait été le défenseur, terminer obscurément une
carrière que des âges plus heureux auraient couverte d'une gloire
impérissable[53]. Quant à son beau-frère Sidoine, il fut arraché à son
troupeau et relégué à Livia, près de Narbonne[54]. Voilà comment
l'Auvergne passa sous le joug des Visigoths.
[50] Grégoire de Tours, ii, 23.
[51] Sidoine Apollinaire, Epist., vi, 12.
[52] Grégoire de Tours, ii, 24.
[53] Jordanes, c. 45. Cf. Binding, Das Burgundisch-Romanische Kœnigreich, p.
90, note 360.
[54] Sidoine Apollinaire, Epist., viii, 3.
La chute de Clermont faisait d'Euric le maître de toute la Gaule au
sud de la Loire: il se hâta de cueillir les fruits de ce nouveau succès.
Les circonstances d'ailleurs le servirent à souhait. En 476, Odoacre
mettait fin à l'empire d'Occident, et peu après mourait Julius Nepos,
l'empereur détrôné, mais légitime, envers lequel les Visigoths étaient
liés par le traité de 475. Ayant les mains libres désormais du côté de
Rome, Euric reprit le programme de ses prédécesseurs, et, plus
heureux, mit enfin la main sur les villes qu'ils avaient si ardemment
convoitées. Arles, qui avait soutenu quatre sièges de la part des
Visigoths, lui ouvrait ses portes, de même que l'opulente Marseille,
la reine du commerce d'Occident. Cette conquête livrait au barbare
tout le littoral méridional de la Gaule; il s'étendait sur la rive gauche
du Rhône jusqu'à la Durance, et il fermait définitivement aux
Burgondes l'accès de la Méditerranée.
Euric était maintenant à la tête d'un royaume immense, qui
ressemblait à un empire. Les frontières en couraient depuis les
Alpes jusqu'au détroit de Gibraltar d'une part, jusqu'aux rives de la
Loire de l'autre, et comprenaient les plus belles contrées de
l'Occident. Maître de ces superbes domaines, Euric pouvait se
considérer comme le véritable héritier des Césars, maintenant
surtout qu'il n'y avait plus personne qui portât le titre impérial. Il fut,
avant Théodoric le Grand, et dans une aussi large mesure que lui,
l'arbitre de l'Europe, et il ne lui a manqué, pour prendre le même
rang devant l'histoire, que des panégyristes pour le vanter et des
chanceliers pour parler en son nom le langage imposant de la
civilisation romaine. Tant qu'il vécut, il n'y eut pas de plus grand nom
que le sien, ni de plus redouté. Sa cour, qu'il tenait alternativement à
Bordeaux[55] et à Toulouse[56], et qu'il transporta enfin à Arles[57]
dans sa nouvelle conquête, était le rendez-vous des ambassadeurs
de tous les peuples. Les Francs et les Saxons s'y rencontraient avec
les Hérules et les Burgondes; les Ostrogoths y coudoyaient les
Huns, et les envoyés de Rome, qui venaient demander des soldats
pour défendre l'Empire, étaient étonnés d'y trouver les députations
du roi des Perses, qui offraient au puissant barbare l'alliance du
despote d'Orient[58]. Les cadeaux et les secours d'Euric prenaient
souvent le chemin de la vieille Germanie, et bien des fois la terreur
de son nom suffit pour y protéger ses amis contre les attaques de
leurs voisins[59].
[55] Sidoine Apollinaire, Epist., viii, 3 et 9.
[56] Id., Ibid., iv, 22.
[57] Jordanes, c. 47.
[58] Sidoine Apollinaire, Epist., viii, 9.
[59] Cassiodore, Variar., iii, 3: Recolite namque Eurici senioris affectum, quantis
vos juvit sæpe muneribus, quotiens a vobis proximarum gentium imminentia bella
suspendit.
Toutefois, cette domination ne sut pas prendre racine dans les
peuples sur lesquels elle s'étendait. Conquérants, les Visigoths le
restèrent toujours, même après que les jours de la conquête furent
passés. Ils ne cessèrent de se considérer comme un peuple de
militaires campés au milieu d'une population de civils qu'il fallait tenir
en respect. Ils ne se préoccupèrent pas de rendre leur autorité
acceptable, se contentant qu'elle fût solide, et oubliant qu'elle avait
besoin pour cela d'être populaire. Ils étalèrent au milieu de ces
Romains d'humeur paisible, et qui ne demandaient qu'à faire bon
accueil à leurs maîtres nouveaux, la morgue et l'insolence du traîne-
sabre à qui la conscience de sa supériorité ne suffit pas, tant qu'il ne
l'a pas affirmée par quelque signe bien visible, par quelque
manifestation bien blessante. Ils semblaient affecter, par leur fidélité
à leurs coutumes nationales au milieu de la vie romaine, d'accentuer
encore l'écart qu'il eût fallu dissimuler. A la cour de Bordeaux,
l'étiquette ne permettait pas au roi de répondre autrement que dans
sa langue gothique aux envoyés impériaux[60]. Il pouvait y avoir
danger pour lui à s'affranchir trop ouvertement des préjugés de sa
nation: tel d'entre eux, comme Ataulf, avait payé de sa vie son
mariage avec une princesse romaine et son engouement pour le
monde impérial. Rien d'instructif à lire comme la description, tracée
par un contemporain, d'une assemblée générale des Visigoths en
armes pour délibérer sur les affaires publiques: on se croirait
transporté dans les forêts d'outre-Rhin par le tableau de cette
réunion tumultueuse de guerriers vêtus de peaux de bêtes, et l'on
est étonné de rencontrer sous le ciel bleu de Toulouse les scènes
qu'on a lues dans la Germanie de Tacite[61].
[60] Ennodius, Vita sancti Epiphanii; cf. Fauriel, I, 530.
[61] Sidoine Apollinaire, Carm., VII, 452 et suiv. Je suis d'ailleurs convaincu que
cet écrivain, ami des amplifications oratoires et poétiques, a notablement accentué
le caractère barbare de cette assemblée.
Mais les populations romaines avaient appris à supporter beaucoup.
Amoureuses avant tout de la paix, et la croyant garantie par la
présence de leurs nouveaux maîtres, elles ne se plaignaient pas
d'eux. Sans les aimer, elles s'habituaient à eux comme à un mal
nécessaire. N'étaient-ils pas là de par la volonté de l'empereur, avec
un titre légitime, et avec la mission de défendre le pays? Ces
défenseurs étaient hautains et arrogants; mais il n'en était jamais
autrement, et cela faisait partie des ennuis que créent aux civils tous
les logements militaires. On avait la ressource de se moquer d'eux
dans les salons, et une épigramme heureuse, qui faisait rire d'eux
dans le beau monde, dédommageait de tant de mortifications! Et
puis, on s'avouait tout bas, parfois même on reconnaissait tout haut
qu'on était plus à l'aise maintenant que du temps des fonctionnaires
impériaux. Une fois établis dans leurs lots, les barbares ne
demandaient pas autre chose: ils savaient même montrer de la
probité dans leurs relations avec les indigènes, et ils ne faisaient pas
fonctionner la machine du fisc avec l'impitoyable virtuosité des gens
du métier. C'est pour ces raisons d'ordre négatif qu'à tout prendre on
s'accommodait d'eux, malgré leur superbe et leur brutalité.
Faut-il s'étonner, après cela, que des hommes désabusés du rêve
romain, des esprits positifs et bourgeois allassent plus loin, et
préparassent les voies à la domination visigothique sur toute la
Gaule? Là où il restait quelque esprit romain, dans les hautes
classes des provinces qui n'avaient pas encore été occupées par les
barbares, en Auvergne surtout, on s'indignait de cette attitude, on la
qualifiait de haute trahison, on en poursuivait la condamnation à
Rome. Mais ce qui prouve que cette indignation portait quelque peu
à faux, et que cet attachement archaïque à l'ombre de l'Empire ne
correspondait plus à l'état général des consciences, c'est
l'indifférence des multitudes, c'est la stupéfaction de ceux-là même
qui se voyaient poursuivis pour haute trahison, et qui ne pouvaient
comprendre qu'ils fussent punissables[62]. La sympathie non
déguisée du clergé catholique pour les barbares le prouve mieux
encore. C'est que, malgré toute leur grossièreté, et même sous leur
vernis d'arianisme, le prêtre catholique sentait battre des cœurs plus
purs que ceux des Romains, et frémir des âmes vierges dont on
pouvait espérer de faire quelque chose. Il faut voir avec quelle
éloquence ces sentiments se traduisent dans le livre de Salvien, qui
peut être regardé comme l'organe d'une grande partie du clergé de
cette époque. Même dans les rangs supérieurs de la hiérarchie, on
ne se cachait pas de préférer les barbares hérétiques aux Romains
impies, et on ne craignait pas d'en témoigner de la manière la plus
éclatante. Lorsque le roi Théodoric Ier fut assiégé dans Toulouse, en
439, par le général Litorius, c'est du côté des barbares qu'allèrent les
vœux des évêques: saint Orientius, évêque d'Auch, ne cessa de
prier pour le succès de leurs armes, et son biographe considère la
victoire de Théodoric comme le résultat surnaturel des prières du
saint[63]!
[62] Lire à ce point de vue l'instructive lettre de Sidoine Apollinaire, Epist., i, 7.
[63] Vita sancti Orientii dans les Bollandistes, t. I de mai; Prosper d'Aquitaine;
Isidore, Chronicon.
En somme donc, l'Aquitaine, prise dans son ensemble, n'était pas
hostile à ses maîtres nouveaux. Elle leur passait beaucoup, elle ne
leur résistait en rien, elle se prêtait avec bonne volonté à leur
régime. Le pouvoir trouva dans la population tous les éléments
nécessaires à son service: elle fournit au roi son premier ministre,
Léon de Narbonne, ses gouverneurs de province, et autant d'agents
de tout grade qu'il lui en demanda. Sidoine lui-même, si longtemps
irréconciliable, finit par se laisser conquérir, et nous le voyons faire
l'inscription du vase offert par son compatriote Evodius à la reine
Ragnahilde[64]. Peu s'en fallut même qu'après avoir fait un madrigal
pour la reine, il ne consentît à écrire le panégyrique du roi. Ce fut un
sentiment de dignité qui l'arrêta. Il se souvint qu'il était le beau-frère
d'Ecdicius, et il s'excusa poliment[65].
[64] Sidoine Apollinaire, Carm., iv, 8.
[65] Id., Epist., iv, 22.
En présence de pareilles dispositions de la part des Romains
d'Aquitaine, combien il eût été facile de les rallier en masse au
régime visigoth, et d'en faire les zélés partisans de la dynastie
barbare! Il eût suffi pour cela de ne pas leur rendre l'obéissance
odieuse et l'attachement impossible, en les violentant jusque dans le
plus intime de leurs consciences. Mais le fanatisme religieux des
Visigoths ne tint compte de rien. Premiers-nés de l'arianisme, ils
avaient au plus haut degré la passion de leur secte, et ils avaient si
bien identifié leur nationalité avec leur hérésie, qu'on disait la foi
gothique pour désigner la doctrine d'Arius[66]. Bien plus, ils étaient
parvenus à faire de l'arianisme une espèce de religion germanique,
en la communiquant successivement à tous les peuples de leur
race. Lorsqu'ils furent établis en Gaule, ils continuèrent cette espèce
d'apostolat, mais en lui donnant, cette fois, un caractère nettement
anti-catholique. Ce n'était plus, en effet, des peuplades païennes
qu'ils endoctrinaient, mais des nations déjà chrétiennes, comme les
Suèves d'Espagne et les Burgondes. Les missionnaires ariens
introduisirent l'hérésie dans ces chrétientés naissantes. Les
princesses ariennes, envoyées comme épouses aux rois suèves[67],
emmenèrent avec elles des prêtres de leur confession, et, à la tête
de ceux-ci, un certain Ajax, Galate d'origine, alla, sous le haut
patronage du roi des Visigoths, jeter la perturbation dans la vie
religieuse d'un peuple ami[68]. Il n'est pas douteux que les Visigoths
n'aient travaillé avec la même ardeur leurs voisins les Burgondes, et
n'aient été la principale influence qui détourna de l'Église ce peuple
déjà en grande partie converti. La campagne de 456-457, que les
deux peuples firent en commun contre les Suèves[69], fournit aux
prédicateurs ariens une occasion excellente de déployer leur zèle
hérétique. Au retour de l'expédition à laquelle ils s'étaient laissé
associer contre un roi catholique, les Burgondes rapportèrent dans
leurs foyers la religion des Goths.
[66] Gothica lex. Voir le Vita sancti Sigismundi dans Jahn, Geschichte der
Burgundionen und Burgundiens, t. II, p. 67, et Revillout, De l'arianisme des
peuples germaniques qui ont envahi l'Empire romain, p. 67.
[67] Idacius, Chronicon, 140 et 226; Isidore de Séville, Chronicon, 33.
[68] Idacius, 232: Ajax natione Galata effectus apostata et senior Arrianus inter
Suevos regis sui auxilio hostis catholicæ fidei et divinæ Trinitatis emersit. A
Gallicana Gothorum habitatione hoc pestiferum inimici hominis virus advectum.
[69] Jordanes, c. 44. Sur la participation des Burgondes à cette campagne,
Binding, o. c., p. 54, note 219, contre Pétigny, II, p. 145, note 2.
Tant que cette propagande fut limitée aux Germains seuls, les
Romains se contentèrent de l'envisager avec la parfaite indifférence
que leur inspiraient toutes les choses barbares. Il n'en fut plus ainsi
lorsqu'ils la virent faire des ravages dans leurs propres rangs. Ils
n'avaient rien de plus précieux que leur foi: elle leur était devenue
plus chère encore depuis la banqueroute de la patrie. On peut même
dire que l'attachement à l'Église catholique restait pour eux la seule
forme du patriotisme. La propagande arienne fut assez active pour
alarmer une nature aussi optimiste que Sidoine Apollinaire, qui
exprime à ce sujet de sérieuses inquiétudes. Dans une lettre à
l'évêque Basile d'Aix, il se plaint de la fausse sécurité des pontifes
qui ne voulaient pas voir le danger, et qui laissaient l'hérésie ravager
impunément leurs troupeaux. «Qu'il me soit permis, écrit-il, de le dire
sans manquer de respect aux évêques, je pleure sur les âmes
livrées à l'ennemi, qui profite du sommeil des pasteurs pour fondre
sur les brebis abandonnées[70].» Un de ces prédicateurs d'arianisme
parmi les populations catholiques était un certain Modahar, que
l'évêque Basile, dans une discussion publique, réduisit au silence,
ce qui lui valut les félicitations de son correspondant[71]. L'orthodoxie
avait les mêmes luttes à soutenir en Burgondie, et l'on voit par les
lettres de Sidoine que Patient de Lyon y défendit la vérité catholique
avec autant d'énergie que Basile l'avait fait à Aix[72]. Les apôtres de
l'arianisme pénétrèrent-ils plus loin, et vinrent-ils disputer aussi à
l'Église catholique les prémices de la nation franque? Nous avons
déjà indiqué que cela n'est guère probable, et c'est seulement sur la
foi de documents apocryphes qu'on a pu parler de l'arianisme de
Cologne[73] et de Tournai[74]. Mais ce que les missions ne faisaient
pas, la diplomatie pouvait le faire, et l'on a vu que la sœur de Clovis
avait été conquise à l'arianisme par les négociateurs du mariage de
Théodoric le Grand.
[70] Sidoine Apollinaire, Epist., vii, 6.
[71] Id., ibid., l. 1.
[72] Id., ibid., vi, 12.
[73] Le concile de Cologne, en 346, dans lequel Euphratas, évêque de cette ville,
aurait été déposé pour crime d'arianisme à l'instance de saint Servais de Tongres,
est une fiction dont je me propose de faire connaître un jour l'origine. Euphratas a
été une victime et non un fauteur de l'arianisme.
[74] Sur les sévices des ariens à Tournai et sur l'expulsion des catholiques, il n'y a
d'autre témoignage que celui d'un Vita Eleutherii, qui n'est pas antérieur au xie
siècle, et qui manque de toute autorité. V. l'Appendice.
Un peuple aussi ardent à propager sa foi chez les catholiques du
dehors devait résister difficilement à la tentation de l'imposer à ceux
du dedans, et la persécution religieuse était comme sa pente
naturelle. Mais les premiers rois visigoths étaient trop fins politiques
pour ne pas comprendre la nécessité de ménager l'Église, et ils
tinrent en bride les impatiences sectaires de leurs compatriotes. Ils
eurent des relations d'amitié avec plusieurs des grands prélats de la
Gaule méridionale; c'est ainsi qu'Orientius, le saint évêque d'Auch,
était le commensal de Théodoric Ier[75], et que Théodoric II parvint,
comme on l'a vu plus haut, à faire la conquête de Sidoine
Apollinaire. Quant au prince Frédéric, nous le voyons réclamer
auprès du pape Hilaire contre une élection épiscopale irrégulière, et
le pape parle de lui en l'appelant son fils[76]. Ces relations courtoises
auraient pu continuer longtemps entre l'Église et les rois: des deux
côtés on y avait intérêt. Mais le fanatisme grossier et aveugle des
masses barbares ne pouvait envisager sans défiance les preuves de
respect que leurs souverains donnaient aux prélats; elles y voyaient
une trahison, elles attendaient d'eux qu'ils les aidassent dans leur
conflit quotidien avec les orthodoxes. Pour résister à leur impatience,
pour leur refuser les mesures de rigueur qu'elles réclamaient à
grands cris, il eût fallu chez les rois une grande somme de justice,
de courage et de clairvoyance politique; il leur eût fallu surtout une
popularité bien assise, et une autorité qui ne tremblât pas devant le
murmure des foules.
[75] Vita sancti Orientii dans les Bollandistes, t. I de mai.
[76] Lettre du pape Hilaire à Léonce d'Arles dans Sirmond, Concil. Gall., I, p. 128.
Le moment vint où ces conditions ne se trouvèrent plus réunies sur
le trône. Euric devait sa couronne à un fratricide; il n'osa pas, en
donnant un nouveau grief à son peuple, s'exposer à s'entendre
rappeler l'ancien; il fut persécuteur comme ses prédécesseurs
avaient été tolérants, par raison d'État. Ce roi, qui se montra plein
d'égards pour l'Auvergne récemment conquise, jusqu'au point de lui
donner un gouverneur indigène et catholique[77], partageait, au
reste, les passions religieuses de son peuple. Le nom de catholique
lui faisait horreur; par contre, il professait un grand attachement pour
le culte arien, auquel il attribuait sa prospérité. On eût pu, dit un
contemporain, le prendre pour un chef de secte plutôt que pour un
chef de peuple[78]. La persécution cependant n'eut pas sous lui le
caractère de brutalité féroce qui marqua celle des Vandales
d'Afrique. On dirait plutôt qu'il chercha, dès les premiers jours, à
donner le change sur ses vrais mobiles, et qu'il voulut avoir l'air de
ne frapper que lorsqu'il était provoqué. Ce n'est pas qu'il reculât
devant l'effusion du sang: nous savons qu'il a immolé plusieurs
évêques[79], et une ancienne tradition locale nous apprend que saint
Vidien de Riez périt pour la foi sous les coups des Goths[80].
D'autres furent envoyés en exil, comme Sidoine Apollinaire, comme
Faustus de Riez, comme Crocus de Nîmes, comme Simplicius, dont
on ignore le siège. Mais c'étaient là des mesures isolées. Ce qui est
plus grave, c'est qu'Euric imagina de faire périr le culte catholique
par l'extinction graduelle de la hiérarchie. Il défendit de pourvoir aux
sièges épiscopaux devenus vacants, et c'est ainsi qu'en peu
d'années la tradition du sacerdoce fut interrompue à Bordeaux, à
Périgueux, à Rodez, à Limoges, à Javoulz, à Eauze, à Comminges,
à Auch, et dans d'autres villes encore. A ceux qui restaient, toute
communication fut interdite avec le dehors; éternelle et illusoire
précaution de tous les persécuteurs contre la puissance de la
solidarité catholique[81]! Les rangs du clergé inférieur
s'éclaircissaient rapidement, et, comme là aussi le recrutement était
à peu près impossible, l'exercice du culte catholique fut arrêté dans
une multitude d'endroits. Les églises abandonnées tombaient en
ruines, les toits s'effondraient, les épines envahissaient les
sanctuaires ouverts à tous les vents, les troupeaux couchaient dans
les vestibules des lieux saints, ou venaient brouter l'herbe au flanc
des autels profanés. Déjà les villes elles-mêmes se voyaient
envahies par ces vides de la mort, et les populations, privées de
leurs pasteurs et de leur culte, s'abandonnaient au désespoir[82].
[77] G. Kurth, Les comtes d'Auvergne au sixième siècle. (Bull. de l'Acad. Roy. de
Belgique, 1899, 11e livraison).
[78] Sidoine Apollinaire, Epist., vii, 6.
[79] Grégoire de Tours, ii, 25.
[80] V. sur saint Vidien les Bollandistes du 8 septembre, t. III, p. 261.
[81] Sidoine Apollinaire, iv, 10.
[82] Le principal document pour l'histoire de cette persécution est la lettre de
Sidoine Apollinaire, vii. 6, reproduite, avec quelques inexactitudes, par Grégoire
de Tours, ii, 25. Le persécuteur a eu plus d'un apologiste qui a trouvé plaisant,
comme fait encore Dahn, Kœnige der Germanen, V, p. 101, de voir dans
l'oppression des consciences catholiques «une mesure de légitime défense contre
l'opposition tenace et dangereuse que les évêques catholiques faisaient partout au
gouvernement». Est-il besoin d'ajouter que Dahn ne fournit pas la moindre preuve
de cette opposition tenace et dangereuse? Kaufmann, Deutsche Geschichte bis
auf Karl den Grossen, Leipzig 1881, t. ii, p. 53, se gêne encore moins. Après un
hymne en l'honneur de la «modération» des rois wisigoths, il dit que si Euric et
Alaric ont exilé ou emprisonné plusieurs évêques et laissé leurs sièges vacants, ce
fut «parce que ces évêques conspiraient avec l'ennemi, ou du moins qu'ils en
étaient soupçonnés. La légende a fait de ces évêques des martyrs, mais il n'y a
pas de doute qu'ils aient été des criminels politiques. Ni la bonté ni la sévérité ne
parvenaient à dompter ces audacieux conspirateurs, etc.» Et, encore une fois,
pour étayer des accusations si graves et si précises, pas l'ombre d'un texte! Il faut
protester hautement contre des procédés de ce genre, qui auraient bientôt fait de
transformer l'histoire en roman. Cf. Malnory, Saint Césaire, p. 46, qui, tout en se
montrant d'une certaine timidité dans l'appréciation de la politique religieuse des
rois visigoths, proteste cependant avec raison, dans une note, contre la tendance
qui «paraît être d'intervertir les rôles de parti pris, en donnant raison aux barbares,
et en réservant tout le blâme pour les Gallo-Romains.»
Ces rigueurs n'avaient toutefois rien d'uniforme, rien de général. Si
elles s'inspiraient d'un plan systématique, il n'y paraissait guère; une
royauté barbare est trop peu armée pour atteindre également, par
des mesures administratives, toutes les provinces d'un vaste
royaume. Qu'on ne s'étonne donc pas de voir, au plus fort de la
crise, la vie catholique se dérouler tranquillement partout où la
persécution n'était pas organisée sur place, des églises se bâtir et
se consacrer[83], des monastères se fonder[84], et, bien plus, des
officiers du roi, des ducs et des comtes, intervenir généreusement
dans les frais de ces fondations. Le duc Victorius, nommé
gouverneur de l'Auvergne par Euric, ne craignit pas de bâtir une
église à Brioude[85], et lorsque mourut saint Abraham, c'est lui qui
prit à sa charge les frais des funérailles[86]. Le roi tolérait cela et ne
pouvait guère s'en plaindre; au contraire, les mêmes raisons qui le
faisaient céder à la fièvre persécutrice des Visigoths lui faisaient
désirer de ne pas pousser à bout la population romaine d'une
contrée récemment conquise, et il ne devait pas être fâché d'avoir
autour de lui des ministres qui, discrètement, réparaient une partie
du mal et réconciliaient la dynastie avec quelques-unes de ses
victimes[87].
[83] Sidoine Apollinaire, Epist., iv, 15. Cf. Revillout, p. 144.
[84] Vic et Vaissette, Histoire du Languedoc, t. I. p. 238.
[85] Grégoire de Tours, ii, 20.
[86] Sidoine Apollinaire, Epist., vii, 17.
[87] G. Kurth, o. c.
A tout prendre, grâce à l'impardonnable aberration du
gouvernement, la situation était singulièrement troublée, et la
clairvoyance politique la plus élémentaire suffisait pour en
comprendre le danger. Comme il arrive toujours, lorsque la
persécution s'abat sur une cause juste, elle stimule et relève le
moral des persécutés. Ces molles populations d'Aquitaine, si
amoureuses de la vie facile, si accueillantes pour le maître barbare,
si vite consolées de la disparition des empereurs, se redressèrent
sous l'affront qu'on faisait à leur foi: elle leur devint plus chère quand
ils la virent opprimée, et les plus indifférents retrouvèrent pour elle
une certaine ardeur patriotique. Et puis, les Aquitains tenaient à leurs
évêques; c'étaient les pères et les défenseurs des cités; on les avait
trouvés sur la brèche chaque fois que l'heure était venue de mourir;
on se souvenait que plusieurs avaient sauvé leur ville, et on se
rappelait avec fierté l'audace du barbare domptée par la majesté
surhumaine de l'homme de Dieu. La guerre faite à l'épiscopat
révoltait donc tout ce qu'il y avait de plus généreux et de plus fier
dans les âmes: tout catholique se sentait atteint dans ceux qu'il
regardait comme des chefs et comme des pères. Le dualisme
jusqu'alors dissimulé entre Goths et Romains reparaissait dans toute
son acuité; en face des barbares hérétiques, toute la population
romaine se retrouvait unie dans un commun sentiment d'exécration.
Tel était le fruit des mesures persécutrices d'Euric: elles avaient
produit ce que n'avaient pu des années entières de pillages et de
spoliations; elles avaient ressuscité le patriotisme romain de la
Gaule, et rappelé à chaque habitant que le Visigoth était un
usurpateur étranger.
Euric mourut en 484, au milieu des mécontentements croissants
causés par sa politique, léguant un triste héritage à son fils Alaric II.
Le royaume ne tenait debout que par la force; dans chaque ville, une
poignée d'hérétiques se faisaient les tyrans de la population; le
moindre événement pouvait amener une explosion. Et précisément à
l'heure où disparaissait l'homme puissant qui avait créé cette
situation et qui semblait jusqu'à un certain point la dominer, on voyait
surgir à l'horizon la monarchie jeune et hardie du peuple franc. En
quelques années de temps, elle était devenue la voisine des
Visigoths sur toute l'étendue de la Loire, et elle plaçait, en face des
catholiques opprimés dans ce malheureux royaume, un spectacle
bien fait pour exciter leur envie et leurs regrets. Dans cette nation à
qui tout souriait, leur religion était celle de tous, le roi recevait la
bénédiction de leurs évêques, et, selon l'expression de saint Avitus,
chaque victoire du souverain était un triomphe pour leur foi.
Quelle éloquence il y avait dans ce simple rapprochement, et avec
quelle force persuasive les faits devaient parler aux esprits! Les
Visigoths le comprirent peut-être avant les catholiques. Ils se
rendirent compte que la présence d'un royaume orthodoxe à leurs
frontières était pour leurs sujets catholiques le plus formidable appel
à la défection. Il les accusèrent de trahison et de sympathies
franques sur la seule foi des légitimes sujets de mécontentement
qu'ils leur avaient donnés. C'était leur conscience de persécuteurs
qui évoquait le fantôme de complots imaginaires. Comme au temps
de l'Empire, quand on prétendait que les chrétiens se réjouissaient
de chaque désastre public, de chaque victoire des Perses ou des
Germains, de même on entendit retentir tous les jours, à l'adresse
des catholiques, les mots de traîtres à l'État et d'ennemis de la
patrie. Et certes, s'il suffisait des calomnies des persécuteurs pour
faire condamner leurs victimes, il faudrait croire que le royaume
visigoth a succombé sous les intrigues des catholiques d'Aquitaine
au moins autant que sous les armes de Clovis. La vérité, c'est que,
si les accusations reparaissent sur toutes les pages de l'histoire de
ce temps, on n'y trouve pas la moindre trace des prétendus
complots. Il n'y avait d'autre révolte que celle des consciences
opprimées; il n'y avait d'autre conspiration que le mécontentement
universel d'une nation blessée dans ses sentiments les plus chers.
Les oppresseurs n'avaient pas le droit de se plaindre de ces
dispositions, qu'ils avaient créées[88].
[88] Cf. Malnory, Saint Césaire, p. 91, avec lequel je me rencontre fréquemment
dans l'appréciation de ces questions délicates, si étrangement défigurées par les
historiens du parti-pris.
Le gouvernement eût pu, au lendemain de la mort d'Euric, liquider le
passé et inaugurer une politique nouvelle: peut-être était-il temps
encore. Le comprit-il, et se rendit-il compte de l'abîme qui allait
s'ouvrir sous ses pas? Nous n'en savons rien. Un incident en
apparence futile nous révèle le profond dédain avec lequel on
continuait de traiter les catholiques dans les régions officielles, et
l'étourderie avec laquelle on courait au-devant de leur ressentiment.
A Narbonne, il y avait une église catholique dont le campanile
enlevait au palais royal la vue de la Livière. La cour ordonna de le
faire abattre, et cet incident, qui en d'autres circonstances aurait
passé inaperçu, devint, à ce qu'il paraît, quelque chose comme un
scandale[89]. Dans l'état où se trouvaient les esprits, rien n'était plus
facile à prévenir. Les ministres du roi, en froissant inutilement la
susceptibilité religieuse d'une ville entière, prouvaient tout au moins
combien ils avaient peu l'esprit politique, et à quel point l'intelligence
de la situation leur manquait.
[89] Grégoire de Tours, Gloria Martyrum, c. 91.
Il faut cependant rendre au gouvernement cette justice que, depuis
l'avènement d'Alaric II, la persécution ne paraît plus avoir été
organisée par le pouvoir, mais par le peuple visigoth lui-même. C'est
l'aveugle et grossier fanatisme des minorités barbares qui mène la
campagne contre l'Église: l'État se borne à laisser faire, ou encore
obéit à la pression qu'exercent sur lui les zélateurs ariens. Voilà
pourquoi, sous le règne d'Alaric plus encore que sous celui de son
père, la lutte religieuse revêt un caractère local. Telles régions
semblent entièrement épargnées par la fièvre des violences: telles
autres en souffrirent d'une manière ininterrompue. C'était le cas,
notamment, des villes voisines de la frontière franque, où, à cause
de la proximité d'un royaume orthodoxe, les catholiques se sentaient
plus forts, et où les hérétiques se montraient plus défiants. Tours
surtout, ce grand foyer religieux de la Gaule, où accouraient les
fidèles de tous les pays, Tours, dont la province ecclésiastique était
comprise presque tout entière dans le royaume de Clovis, devait
éveiller au plus haut degré la sollicitude inquiète des Visigoths.
Comment le chef du troupeau catholique dans cet avant-poste du
royaume hérétique eût-il pu être épargné par l'accusation de
trahison? Il ne le fut pas. Saint Volusien, qui occupait alors le siège
pontifical, fut chassé, emmené captif à Toulouse et traîné plus tard
en Espagne, où il mourut dans les tribulations[90]. Son successeur
Verus eut la même destinée: lui aussi fut accusé de conspirer avec
les Francs, et arraché à son troupeau. Le vieux Ruricius de Limoges
dut prendre à son tour le chemin de l'exil; nous le retrouvons à
Bordeaux, où l'ombrageux tyran aimait à mettre en observation les
hommes qu'il poursuivait de ses injustes soupçons[91].
[90] Grégoire de Tours, ii, 26, et x, 31.
[91] Sur l'exil de Ruricius, voir ses Epistolæ, 17, et sur son séjour à Bordeaux,
ibid., 33. Cf. la préface de Krusch, pp. lxiii-lxiv. Quant à saint Quentien de Rodez,
il ne fut pas chassé de son diocèse sous le règne d'Alaric II, car nous le voyons
siéger aux conciles d'Agde en 506 et d'Orléans en 511; sa fuite à Clermont eut lieu
quelques années après cette date, pendant le temps que les Goths avaient
momentanément repris le Rouergue. C'est Grégoire de Tours, ii, 36, qui s'est
trompé en antidatant ces événements. Voir A. de Valois, I, p. 218 et suiv., et
Longnon, p. 518.
Mais de toutes les victimes de la jalousie des Visigoths, la plus
illustre fut sans contredit le grand homme qui était alors métropolitain
d'Arles, et la plus brillante lumière du royaume d'Aquitaine. Avec
saint Remi et saint Avitus, saint Césaire forme la triade sacrée en
laquelle se résumaient alors toutes les gloires et toutes les forces de
l'Église des Gaules. Il ne fut pas appelé, comme eux, à jouer un
grand rôle politique: il ne devint pas, comme Remi, le créateur d'une
nation et l'oracle d'un grand peuple, ni même, comme Avitus, le
conseiller et l'ami d'un roi; mais comme docteur catholique et comme
maître de la vie spirituelle, il n'eut pas d'égal au sixième siècle.
Pasteur du troupeau catholique dans la grande ville romaine qui était
tombée l'une des dernières aux mains des Visigoths, et entouré par
les fidèles de son Église d'une vénération sans bornes, il ne pouvait
guère échapper aux suspicions des ariens. Seulement, comme il
était Burgonde d'origine, étant né à Chalon-sur-Saône, et que les
Francs étaient bien loin, c'est à ses anciens rois qu'il fut accusé de
vouloir livrer sa ville. Ceux qui se sont fait l'écho de cette calomnie
n'ont pas réfléchi que Gondebaud était arien, et qu'il n'y avait pas
d'apparence qu'un évêque catholique trahît un monarque arien pour
un autre[92]. Mais les passions ne raisonnent pas. Césaire était
l'objet de la haine des ariens, et les ariens étaient les maîtres: il fut
enlevé à son siège et exilé à Bordeaux[93].
[92] On est étonné de retrouver cette accusation dans le livre d'Arnold, Cæsarius
von Arelate, dont l'auteur fait généralement preuve d'indépendance d'esprit et
d'une critique large et ferme. Selon Arnold, Césaire a rêvé de livrer Arles aux
Burgondes, parce que, sujet de Gondebaud, il aurait pu combattre avec plus de
chances de succès les prétentions de saint Avitus de Vienne à la primatie. Rien de
plus invraisemblable en soi, et de plus contraire aux sources.
[93] Vita sancti Cæsarii, i, 12; dans Mabillon, Acta Sanct., t. I, p. 640.
Pendant qu'ils expulsaient ainsi de leurs diocèses les plus grands et
les plus saints évêques du pays, les Visigoths y laissaient pénétrer
un prélat étranger, proscrit et fugitif, qui ne cherchait qu'un coin de
terre pour y mourir tranquille, et qui, à son insu, devait devenir le
plus redoutable agitateur des catholiques d'Aquitaine. Il s'appelait
Eugène, il était évêque de Carthage, et il avait été à la tête de
l'Église d'Afrique au cours de l'atroce persécution par laquelle les
Vandales avaient fait revivre les jours les plus sombres du règne de
Dioclétien. Eugène était entouré de la double auréole du confesseur
et du martyr. Il avait confessé la foi devant les rois persécuteurs, il
avait souffert la déposition, l'exil, les outrages et les mauvais
traitements quotidiens; frappé enfin d'une sentence capitale, il avait
été mené au champ du supplice, et, après avoir assisté à l'exécution
de ses collègues, il s'était vu subitement gracié, à une heure où il
n'avait plus rien à attendre de la vie ni rien à craindre de la mort.
Enfin, il avait été relégué en Gaule, comme si, en le mettant sous la
surveillance des persécuteurs de ce pays, les persécuteurs d'Afrique
avaient voulu garder comme otage l'homme dont ils n'avaient pas
osé faire un martyr! Calcul funeste, puisqu'en offrant dans sa
personne, à des populations catholiques, le témoin vivant des excès
du fanatisme arien, ils fournissaient à leur haine de l'arianisme un
aliment efficace. Pour les Aquitains, les Visigoths devinrent
solidaires de toutes les atrocités de la persécution vandale; plus on
vénérait les vertus et la sainteté de la noble victime, plus on
abhorrait des maîtres en qui on voyait les complices de ses
bourreaux. Eugène mourut à Albi en 505, après avoir fait rayonner
dans sa personne, aux yeux de toute l'Aquitaine, l'éclat des plus
hautes vertus et le mérite des plus saintes souffrances. A son insu,
comme nous l'avons dit, il avait plus que personne contribué à miner
l'autorité de l'arianisme en Gaule[94].
[94] Sur lui, voir Grégoire de Tours, ii, 3; et Gloria Martyrum, 27; Victor de Vita et le
Vita sancti Eugenii, 13 juillet.
Le gouvernement s'aperçut enfin que le sol se dérobait sous lui, et
que l'État allait s'effondrer. Partout autour de lui régnaient la
désaffection et le découragement. Il sentait, dans les sourds
grondements qui sortaient des masses populaires, les signes avant-
coureurs d'un orage terrible, et le bruit des acclamations qui
saluaient l'entrée de Clovis dans les villes du nord de la Loire avait
pour lui une signification sinistre. Il voulut alors revenir sur ses pas,
et il fit, sous l'empire de la peur, les démarches qu'auraient dû lui
dicter depuis longtemps la justice ou du moins la prudence. Il montra
qu'il était assez fort pour ne pas céder, quand il voulait, aux
fantaisies persécutrices des Goths, et les sévices contre la
hiérarchie catholique cessèrent à partir du jour où ils semblèrent
désapprouvés par lui. Comme l'avait fait Gondebaud au lendemain
d'une expérience pénible, il imagina de donner une satisfaction aux
catholiques en réglant légalement leur situation, et le bréviaire
d'Alaric, résumé de la législation impériale fait pour leur usage, fut,
de même que la loi Gombette, quelque chose comme un
dédommagement accordé aux persécutés.
Ce ne fut pas tout. Allant plus loin dans la voie des réparations,
Alaric II rendit à leurs troupeaux les évêques déposés. De ce
nombre furent Verus de Tours[95], Ruricius de Limoges et saint
Césaire d'Arles; ce dernier, avant de reprendre possession de son
siège, avait eu la satisfaction de voir son accusateur confondu[96].
Bien plus, ce grand homme fut autorisé à réunir un concile national.
En effet, au mois de septembre 506, vingt-quatre évêques et dix
prêtres délégués d'autant d'évêques absents se réunirent à Agde,
dans l'église Saint-André. L'épiscopat catholique, après le rude

You might also like