https://github.com/rjoydip/win_taskkill
Wrapper for the Windows `taskkill` command. Ends one or more tasks or processes.
https://github.com/rjoydip/win_taskkill
deno tasks windows
Last synced: about 2 months ago
JSON representation
Wrapper for the Windows `taskkill` command. Ends one or more tasks or processes.
- Host: GitHub
- URL: https://github.com/rjoydip/win_taskkill
- Owner: rjoydip
- License: mit
- Created: 2022-10-25T16:25:12.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2022-10-25T16:25:22.000Z (over 3 years ago)
- Last Synced: 2025-02-05T18:02:23.975Z (over 1 year ago)
- Topics: deno, tasks, windows
- Language: TypeScript
- Homepage:
- Size: 3.91 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# win_taskkill 
> Wrapper for the Windows [`taskkill`](https://technet.microsoft.com/en-us/library/bb491009.aspx) command. Ends one or more tasks or processes.
**Port of [taskkill](https://github.com/sindresorhus/taskkill)**
> Note: **Test is incomplete (Welcome for PR)** due to "Bad resourse ID"
## Install
```sh
deno install --allow-run -f --name taskkill "deno.land/x/win_taskkill/cli.ts"
```
## Usage CLI
```sh
$ taskkill --help
Usage
$ taskkill [ …]
Description:
Wrapper for the Windows command. Ends one or more tasks or processes.
Options:
--help -h, - Show this help.
--force - Forcefully stop process.
--tree, - Terminate all child processes.
--system, - Name or IP address of a remote computer.
--username, - User specified by User or Domain\User.
--password, - Password of the user account.
--filter, - Types of processes to termination.
Examples:
$ taskkill 1337
$ taskkill 1337 --force
$ taskkill --force --filter "USERNAME eq NT AUTHORITY\SYSTEM"
$ taskkill --system srvmain --force
$ taskkill --system srvmain --username maindom\hiropln --password p@ssW23
```
## Usage API
```ts
import { win_taskkill } from "deno.land/x/win_taskkill/mod.ts";
// or
import win_taskkill from "deno.land/x/win_taskkill/mod.ts";
(async () => {
await taskkill([4970, 4512]);
})();
```
## API
See the [`taskkill` docs](https://technet.microsoft.com/en-us/library/bb491009.aspx) for more.
### taskkill(input, [options])
Returns a `Promise`.
#### input
Type: `number[] | string[]`
One or more process IDs or image names, but not mixed.
#### options
The `system`, `username`, `password` options are mutually inclusive.
##### system
Type: `string`
Name or IP address of a remote computer (do not use backslashes). The default is the local computer.
##### username
Type: `string`
User specified by User or Domain\User. The default is the permissions of the current logged on user on the computer issuing the command.
##### password
Type: `string`
Password of the user account for the specified `username`.
##### filter
Type: `string`
Types of processes to include or exclude from termination.
See the [`taskkill` docs](https://technet.microsoft.com/en-us/library/bb491009.aspx) for supported filters.
##### force
Type: `boolean`
Forcefully terminate processes. Ignored for remote processes as all remote processes are forcefully terminated.
##### tree
Type: `boolean`
Terminate all child processes along with the parent process, commonly known as a tree kill.
## Inspired
- [taskkill](https://github.com/sindresorhus/taskkill) - Wrapper for the Windows `taskkill` command. Ends one or more tasks or processes.