The WMI command-line (WMIC) utility provides a command-line interface for WMI. WMIC is compatible with existing shells and utility commands.
To use verbs in WMIC, enter the alias name followed by the verb. If an alias does not support a verb, you receive the message "provider is not capable of the attempted operation." Most aliases support the following verbs.
Returns the result of the
Associators of (<wmi_object>)query where <wmi_object> is the path of objects returned by the PATH or CLASS commands. The results are instances associated with the object. When ASSOC is used with an alias, the classes with the class underlying the alias are returned. By default the output is returned in HTML format.
The ASSOC verb has the following switches.
Switch Description /RESULTCLASS:<classname> Returned endpoints associated with the source object must belong to, or be derived from the specified class. /RESULTROLE:<rolename> Returned endpoints must play a specific role in associations with the source object. /ASSOCCLASS:<assocclass> Returned endpoints must be associated with the source through the specified class, or one of its derived classes.
Example: OS ASSOC
Executes a method.
Example: SERVICE WHERE CAPTION='TELNET' CALL STARTSERVICE
Creates a new instance and sets the property values. CREATE cannot be used to create a new class.
Example: ENVIRONMENT CREATE NAME="TEMP", VARIABLEVALUE="NEW"
Deletes the current instance or set of instances. DELETE can be used to delete a class.
Example: PROCESS WHERE NAME="CALC.EXE" DELETE
Retrieve specific property values.
GET has the following switches.
Switch Description /VALUE Output is formatted with each value listed on a separate line and with the name of the property. /ALL Output is formatted as a table. /TRANSLATE:<translation table> Translate the output using the translation table named by the command. The translation tables BasicXml and NoComma are included with WMIC. /EVERY:<interval> Repeat the command every <interval> seconds. /FORMAT:<format specifier> Specifies a key word or XSL file name to format the data.
Example: PROCESS GET NAME
Shows data. LIST is the default verb.
LIST has the following adverbs.
Adverb Description BRIEF Core set of the properties. FULL Full set of properties. This is the default adverb for LIST. INSTANCE Instance paths only. STATUS Status of the objects. SYSTEM System properties.
LIST has the following switches.
Switch Description /TRANSLATE:<translation table> Translate the output using the translation table named by the command. The translation tables BasicXml and NoComma are included with WMIC. /EVERY:<interval> Repeat the command every <interval> seconds. /FORMAT:<format specifier> Specifies a key word or XSL file name to format the data.
Example: PROCESS LIST BRIEF
Assigns values to properties. Example: ENVIRONMENT SET NAME="TEMP", VARIABLEVALUE="NEW"
Global switches are used to set defaults for the WMIC environment. You can view the current value of the conditions set by these switches by entering the CONTEXT command.
Namespace the alias uses—typically. The default is root\cimv2.
Namespace WMIC typically looks in for aliases and other WMIC information.
Computer names, comma delimited. All commands are synchronously executed against all computers listed in this value. File names must be prefixed with &. Computer names within a file must be comma delimited or on separate lines.
Enable or disable all privileges.
Example: /PRIVILEGES:ENABLE or /PRIVILEGES:DISABLE
Display the success or failure of all functions used to execute WMIC commands.
Example: /TRACE:ON or /TRACE:OFF
Records all output to an XML file. Output is also displayed at the command prompt.
Typically, delete commands are confirmed.
Example: /INTERACTIVE:ON or /INTERACTIVE:OFF
- /FAILFAST on|off|TimeoutInMilliseconds
If ON the /NODE computers are pinged before sending WMIC commands to them. If a computer does not respond the WMIC commands are not sent to it.Windows 2000, Windows NT 4.0, and Windows Me/98/95: Timeout in milliseconds is not available.
Example: "/FAILFAST:ON" or "/FAILFAST:OFF"
User name used by WMIC when accessing the /NODE computers or computers specified in the aliases. You are prompted for the password. A user name cannot be used with the local computer.
Password used by WMIC when accessing the /NPDE computers. The password is visible at the command line.
Specifies a mode for all output redirection. Output does not appear at the command line and the destination is cleared before output begins. Valid values are STDOUT, CLIPBOARD or a file name.
Specifies a mode for all output redirection. Output does not appear at the command line and the destination is not cleared before output begins and output is appended to the end of the current contents of the destination. Valid values are STDOUT, CLIPBOARD or a file name.
Used with the LIST and GET /EVERY switch. If AGGREGATE is ON, LIST and GET display their results when all computers in the /NODE have either responded or timed out. If AGGREGATE is OFF, LIST and GET display their results as soon as they are received.
Example: /AGGREGATE:OFF or /AGGREGATE:ON
The following WMIC commands are available at all times.
Escape from the default alias mode of WMIC to access classes in the WMI schema directly.
Example: WMIC /OUTPUT:c:\ClassOutput.htm CLASS Win32_SoundDevice
Escape from the default alias mode of WMIC to access instances in the WMI schema directly.
Example: WMIC /OUTPUT:c:\PathOutput.txt PATH Win32_SoundDevice GET /VALUE
Display the current values of all global switches.
Example: WMIC CONTEXT
Exit from WMIC.
Example: WMIC QUIT
Exit from WMIC.
Example: WMIC EXIT
Minimum supported client
|Windows XP [desktop apps only]|
Minimum supported server
|Windows Server 2003 [desktop apps only]|
Build date: 11/19/2012