tasklist

Displays a list of currently running processes on the local computer or on a remote computer. Tasklist replaces the tlist tool.

This command replaces the tlist tool.

Syntax

Parameters

Parameter	Description
/s	Specifies the name or IP address of a remote computer (do not use backslashes). The default is the local computer.
/u \	Runs the command with the account permissions of the user who is specified by or by \ . The /u parameter can be specified only if /s is also specified. The default is the permissions of the user who is currently logged on to the computer that is issuing the command.
/p

Specifies the password of the user account that is specified in the /u parameter. /m Lists all tasks with DLL modules loaded that match the given pattern name. If the module name is not specified, this option displays all modules loaded by each task. svc Lists all the service information for each process without truncation. Valid when the /fo parameter is set to table. /v Displays verbose task information in the output. For complete verbose output without truncation, use /v and /svc together. /fo

Specifies the format to use for the output. Valid values are table, list, and csv. The default format for output is table. /nh Suppresses column headers in the output. Valid when the /fo parameter is set to table or csv. /fi Specifies the types of processes to include in or exclude from the query. You can use more than one filter or use the wildcard character ( \ ) to specify all tasks or image names. The valid filters are listed in the Filter names, operators, and values section of this article. /? Displays help at the command prompt.

Filter names, operators, and values

Filter Name	Valid Operators	Valid Value(s)
STATUS	eq, ne	RUNNING | NOT RESPONDING | UNKNOWN . This filter isn’t supported if you specify a remote system.
IMAGENAME	eq, ne	Image name
PID	eq, ne, gt, lt, ge, le	PID value
SESSION	eq, ne, gt, lt, ge, le	Session number
SESSIONNAME	eq, ne	Session name
CPUtime	eq, ne, gt, lt, ge, le	CPU time in the format HH:MM:SS, where MM and SS are between 0 and 59 and HH is any unsigned number
MEMUSAGE	eq, ne, gt, lt, ge, le	Memory usage in KB
USERNAME	eq, ne	Any valid user name ( or )
SERVICES	eq, ne	Service name
WINDOWTITLE	eq, ne	Window title. This filter isn’t supported if you specify a remote system.
MODULES	eq, ne	DLL name

Examples

To list all tasks with a process ID greater than 1000, and display them in csv format, type:

To list the system processes that are currently running, type:

To list detailed information for all processes that are currently running, type:

To list all the service information for processes on the remote computer srvmain, which has a DLL name beginning with ntdll, type:

To list the processes on the remote computer srvmain, using the credentials of your currently logged-on user account, type:

To list the processes on the remote computer srvmain, using the credentials of the user account Hiropln, type:

tasklist tasklist

Отображает список запущенных в данный момент процессов на локальном или удаленном компьютере. Displays a list of currently running processes on the local computer or on a remote computer. Tasklist заменяет средство TList . Tasklist replaces the tlist tool.

Эта команда заменяет средство TList . This command replaces the tlist tool.

Синтаксис Syntax

Параметры Parameters

Параметр Parameter	Описание Description
ключ /s	Указывает имя или IP-адрес удаленного компьютера (не используйте символы обратной косой черты). Specifies the name or IP address of a remote computer (do not use backslashes). По умолчанию это локальный компьютер. The default is the local computer.
/u \ /u \	Выполняет команду с разрешениями учетной записи пользователя, заданного или пользователем \ . Runs the command with the account permissions of the user who is specified by or by \ . Параметр /u может быть указан только в том случае, если задано также значение /s . The /u parameter can be specified only if /s is also specified. По умолчанию заданы разрешения пользователя, который в данный момент вошел в систему компьютера, выполняющего команду. The default is the permissions of the user who is currently logged on to the computer that is issuing the command.
/p

Указывает пароль учетной записи пользователя, указанной в параметре /u . Specifies the password of the user account that is specified in the /u parameter. /m /m Список всех задач с загруженными модулями DLL, которые соответствуют заданному имени шаблона. Lists all tasks with DLL modules loaded that match the given pattern name. Если имя модуля не указано, в этом параметре отображаются все модули, загруженные каждой задачей. If the module name is not specified, this option displays all modules loaded by each task. SVC svc Список всех сведений о службе для каждого процесса без усечения. Lists all the service information for each process without truncation. Допустим, если для параметра /FO задано значение Table. Valid when the /fo parameter is set to table. /v /v Отображает подробные сведения о задаче в выходных данных. Displays verbose task information in the output. Для получения подробных выходных данных без усечения используйте /v и /SVC вместе. For complete verbose output without truncation, use /v and /svc together. #b1

/fo

Указывает формат, используемый для выходных данных. Specifies the format to use for the output. Допустимые значения: Table, List и CSV. Valid values are table, list, and csv. Формат выходных данных по умолчанию — Table. The default format for output is table.
использован /nh	Подавляет вывод заголовков столбцов в выходных данных. Suppresses column headers in the output. Допустим, если для параметра /FO задано значение Table или CSV. Valid when the /fo parameter is set to table or csv.
/Fi /fi	Указывает типы процессов, включаемых в запрос или исключаемых из него. Specifies the types of processes to include in or exclude from the query. Можно использовать более одного фильтра или использовать подстановочный знак ( \ ) для указания всех задач или имен изображений. You can use more than one filter or use the wildcard character ( \ ) to specify all tasks or image names. Допустимые фильтры перечислены в разделе имена фильтров, операторы и значения этой статьи. The valid filters are listed in the Filter names, operators, and values section of this article.
/? /?	Отображение справки в командной строке. Displays help at the command prompt.

Имена фильтров, операторы и значения Filter names, operators, and values

Имя фильтра Filter Name	Допустимые операторы Valid Operators	Допустимые значения Valid Value(s)
Состояние STATUS	eq, ne eq, ne	RUNNING | NOT RESPONDING | UNKNOWN . RUNNING | NOT RESPONDING | UNKNOWN . Этот фильтр не поддерживается, если указана удаленная система. This filter isn’t supported if you specify a remote system.
IMAGENAME IMAGENAME	eq, ne eq, ne	Имя образа Image name
ИД процесса PID	eq, ne, gt, lt, ge, le eq, ne, gt, lt, ge, le	Значение PID PID value
SESSION SESSION	eq, ne, gt, lt, ge, le eq, ne, gt, lt, ge, le	Номер сеанса Session number
SESSIONNAME SESSIONNAME	eq, ne eq, ne	Имя сеанса Session name
CPUtime CPUtime	eq, ne, gt, lt, ge, le eq, ne, gt, lt, ge, le	Время ЦП в формате чч: мм: СС, где mm и SS находятся в диапазоне от 0 до 59, а чч — любое число без знака CPU time in the format HH:MM:SS, where MM and SS are between 0 and 59 and HH is any unsigned number
мемусаже MEMUSAGE	eq, ne, gt, lt, ge, le eq, ne, gt, lt, ge, le	Использование памяти в КБ Memory usage in KB
USERNAME USERNAME	eq, ne eq, ne	Любое допустимое имя пользователя ( или ) Any valid user name ( or )
Обслуживание SERVICES	eq, ne eq, ne	Имя службы Service name
WINDOWTITLE WINDOWTITLE	eq, ne eq, ne	Заголовок окна. Window title. Этот фильтр не поддерживается, если указана удаленная система. This filter isn’t supported if you specify a remote system.
МОДУЛЕ MODULES	eq, ne eq, ne	Имя DLL DLL name

Примеры Examples

Чтобы получить список всех задач с идентификатором процесса, превышающим 1000, и отобразить их в формате CSV, введите: To list all tasks with a process ID greater than 1000, and display them in csv format, type:

Чтобы получить список системных процессов, выполняемых в данный момент, введите: To list the system processes that are currently running, type:

Чтобы вывести подробные сведения обо всех выполняющихся процессах, введите: To list detailed information for all processes that are currently running, type:

Чтобы получить список всех сведений о службе для процессов на удаленном компьютере срвмаин с именем DLL, начинающимся с NTDLL, введите: To list all the service information for processes on the remote computer srvmain, which has a DLL name beginning with ntdll, type:

Чтобы получить список процессов на удаленном компьютере срвмаин, используя учетные данные текущей учетной записи пользователя, выполнившего вход в систему, введите: To list the processes on the remote computer srvmain, using the credentials of your currently logged-on user account, type:

Чтобы получить список процессов на удаленном компьютере срвмаин, используя учетные данные хироплн учетной записи пользователя, введите: To list the processes on the remote computer srvmain, using the credentials of the user account Hiropln, type:

Get Task List

Gets the values of the properties for all of the tasks in the specified job.

Request

You can specify the Get Task List request as follows.

Method	Request URI
GET (before HPC Pack 2016)	https://head_node_name:port/WindowsHPC/HPC_cluster_name/Job/job_identifier/Tasks
GET (HPC Pack 2016)	https://head_node_name:port/WindowsHPC/Job/job_identifier/Tasks

For instances of the REST web service that are hosted in Azure, the head node name should have a format of Windows_Azure_service_name.cloudapp.net.

To get the name to use for an HPC cluster that runs at least Microsoft HPC Pack 2008 R2 with Service Pack 3 (SP3), use the Get Clusters operation.

URI Parameters

You can specify the following additional parameters on the request URI.

Optional. A comma-separated list of the names for the properties of the tasks for which you want to get values.

If you do not specify the Properties parameter, the response contains values for the TaskId, Name, State, CommandLine, ExitCode, ParentJobId, JobTaskId, and InstanceId properties. For a list of the properties that you can specify, see the Remarks section.

If a property with a specified name does not exist for a task, an error occurs.

Optional. Specifies whether to get properties only for the master task for a parametric sweep task, or for all of the subtasks instead. True indicates that you want to get properties for all of the subtasks. False indicates that you want to get properties only for the master task. The default value is True.

Specifies internal data from the x-ms-continuation-QueryId header from the response in the previous Get Task List operation in a continuation sequence of Get Task List operations. For more information, see the Response Headers section later in this topic.

Specifies internal data from the x-ms-continuation-CurrentObjectNumber header from the response in the previous Get Task List operation in a set of Get Task List operations. For more information, see the Response Headers section later in this topic. Deprecated starting with Microsoft HPC Pack 2008 R2 with Service Pack 3 (SP3).

Optional. Specifies the version of the operation to use for this request. To specify MicrosoftВ HPCВ PackВ 2008В R2 with ServiceВ PackВ 3 (SP3), use a value of 2011-11-01. The minimum version that supports this URI parameter is MicrosoftВ HPCВ PackВ 2008В R2 with SP3.

The value of this URI parameter is ignored if the request also contains the api-version header.

Optional. Specifies OData filters to use for this request in the following format «$filter= %20and%20 …».

To filter the tasks by a valid task state, use the filter «TaskState%20eq%20 «. To retrieve tasks whose state changed after a certain date and time, use the filter «ChangeTimeFrom%20eq%20 «.

A null value is ignored.

The minimum version that supports this URI parameter is Microsoft HPC Pack 2012. To use this parameter, also specify the Render URI parameter set to RestPropRender and a minimum api-version value of 2012-11-01.

Example: «$filter=TaskState%20eq%20queued%20and%20 ChangeTimeFrom%20eq%202015-10-16&Render=RestPropRender&api-version=2012-11-01». For information about task states, see TaskState.

Parameter	Description
Properties
Render	Required if the $filter URI parameter is specified. Set the value to RestPropRender to specify that the response body is formatted in XML compatible with MicrosoftВ HPCВ PackВ 2008В R2 with ServiceВ PackВ 2 (SP2). The minimum version that supports this URI parameter is MicrosoftВ HPCВ PackВ 2012.
SortTasksBy	Optional. A task property by which tasks will be sorted. If this parameter is not specified or a property with a specified name does not exist for a task, the result will be sorted by task Id.
RowsPerRead	Optional. Specifies how many lines of data to retrieve each time. The default is set to 10. At least one record will be retrieved.

Request Headers

The following table describes required and optional request headers.

Optional. Specifies the version of the operation to use for this request. To specify MicrosoftВ HPCВ PackВ 2008В R2 with SP3, use a value of 2011-11-01. The minimum version that supports this header is MicrosoftВ HPCВ PackВ 2008В R2 with SP3.

The value specified in this header overrides the value specified in the api-version URI parameter if both are specified.

Optional. Specifies the version of the operation to use for this request.

Deprecated beginning with Microsoft HPC Pack 2008 R2 with Service Pack 3 (SP3).

Request Body

Response

The response includes an HTTP status code, a set of response headers, and a response body in XML format.

Status Code

A successful operation returns status code 200 (OK). For more information about status codes, see HttpStatusCode.

The error response is dependent upon the api-version used in the request. If the api-version is not provided, or CCP_Version is specified, then the error response will be an XML string (Note: The error message will vary based on the error):

If the api-version is 2011-11-01 or later, the error message will be a more descriptive XML response (Note: Values will vary based on the error):

Response Headers

The response for this operation includes the following headers.

Request Header	Description
api-version

A comma-separated list of RFC 1918 IP addresses that indicate the sequence of instances of the REST web service that the operation called in order from to right.

Only responses from instances of the REST web service that are hosted on Azure contain this header. Responses from instances of the REST web service that are hosted on premise omit this header.

This header is supported beginning with Microsoft HPC Pack 2008 R2 with SP3 and is not available in previous versions.

Enables large sets of data to be returned in smaller responses across a continuation sequence of several requests. The value of this header is to be assigned to the queryId query string parameter in the next call in the sequence of calls to the Get Task List operation. The response to the Get Task List operation contains this header as long as additional data remains to be processed. You use the values of this header for one operation in the queryId URI parameter for the next operation.

The format of the data in this header is not guaranteed to remain unchanged. You should only copy the data in this header from one operation in a set of multiple operations to the queryId URI parameter for the next operation. You should not use the data in this header or depend on the format of the data in this header in any other way.

For an example of how to use this header and URI parameter in a way that potential changes will not impact, see the code for the sample client applications for REST API. For information about how to get these sample client applications, see Getting Sample Programs that use the REST API.

Contains internal data that support working with sets of data that are too large or too expensive to get in a single response body by dividing the Get Task List operation into a set of multiple Get Task List operations. The response to the Get Task List operation contains this header as long as additional data remains to be processed. You use the values of this header for one operation in the CurrentObjectNumber URI parameter for the next operation.

The format of the data in this header is not guaranteed to remain unchanged. You should only copy the data in this header from one operation in a set of multiple operations to the CurrentObjectNumber URI parameter for the next operation. You should not use the data in this header or depend on the format of the data in this header in any other way.

For an example of how to use this header and URI parameter in a way that potential changes will not impact, see the code for the sample client applications for REST API.

Deprecated starting with Microsoft HPC Pack 2008 R2 with SP3.

The response for this operation also includes standard HTTP headers. All standard headers conform to the HTTP/1.1 protocol specification.

Response Body

The format of the response body is as follows.

The following table describes each of the elements in the response XML.

Response Header	Description
x-ms-hpc-authoritychain
x-ms-continuation-CurrentObjectNumber

Represents the set of tasks in the specified job.

Represents a single task.

Represents the set of properties for the task.

Represents a single property for the task.

Contains the name of the property.

Contains the value of the property.

Remarks

The following table shows the task properties for which you can get the values or by which you can sort results. For information about the property, including the versions of Microsoft HPC Pack that support it, see the corresponding property of the ISchedulerTask or ITaskId interface in the managed API for Microsoft HPC Pack.

Element	Description
ArrayOfObject

Property	Corresponding ISchedulerTask or ITaskId Property
TaskId	ISchedulerTask.TaskId
Name	ISchedulerTask.Name
State	ISchedulerTask.State
PreviousState	ISchedulerTask.PreviousState
MinCores	ISchedulerTask.MinimumNumberOfCores
MaxCores	ISchedulerTask.MaximumNumberOfCores
MinNodes	ISchedulerTask.MinimumNumberOfNodes
MaxNodes	ISchedulerTask.MaximumNumberOfNodes
MinSockets	ISchedulerTask.MinimumNumberOfSockets
MaxSockets	ISchedulerTask.MaximumNumberOfSockets
RuntimeSeconds	ISchedulerTask.Runtime
SubmitTime	ISchedulerTask.SubmitTime
CreateTime	ISchedulerTask.CreateTime
EndTime	ISchedulerTask.EndTime
ChangeTime	ISchedulerTask.ChangeTime
StartTime	ISchedulerTask.StartTime
ParentJobId	ISchedulerTask.ParentJobId
CommandLine	ISchedulerTask.CommandLine
WorkDirectory	ISchedulerTask.WorkDirectory
RequiredNodes	ISchedulerTask.RequiredNodes
DependsOn	ISchedulerTask.DependsOn
IsExclusive	ISchedulerTask.IsExclusive
IsRerunnable	ISchedulerTask.IsRerunnable
StdOutFilePath	ISchedulerTask.StdOutFilePath
StdInFilePath	ISchedulerTask.StdInFilePath
StdErrFilePath	ISchedulerTask.StdErrFilePath
ExitCode	ISchedulerTask.ExitCode
RequeueCount	ISchedulerTask.RequeueCount
StartValue	ISchedulerTask.StartValue
EndValue	ISchedulerTask.EndValue
IncrementValue	ISchedulerTask.IncrementValue
ErrorMessage	ISchedulerTask.ErrorMessage
Output	ISchedulerTask.Output
UserBlob	ISchedulerTask.UserBlob
Type	ISchedulerTask.Type
IsServiceConcluded	ISchedulerTask.IsServiceConcluded
FailJobOnFailure	ISchedulerTask.FailJobOnFailure
FailJobOnFailureCount	ISchedulerTask.FailJobOnFailureCount
AllocatedCoreIds	ISchedulerTask.AllocatedCoreIds
AllocatedNodes	ISchedulerTask.AllocatedNodes
HasRuntime	ISchedulerTask.HasRuntime
JobTaskId	ITaskId.JobTaskId
InstanceId	ITaskId.InstanceId
TaskValidExitCodes	ISchedulerTask.ValidExitCodes

Requirements

HPC Pack 2008 R2 with at least SP2, or a later version of HPC Pack.