***

title: ecs task-def command reference
approved: 2025-05-30T00:00:00.000Z
max-toc-depth: 2
----------------

The `ecs task-def` command prints a task definition to be added to an ECS cluster to run the Postman Insights Agent as a daemon in host-networking mode on every EC2 instance in the cluster. For help, use `-h` or `--help`.

## Usage

```bash
postman-insights-agent ecs task-def [flags]
```

## Flags

* `--cluster string` - The name or ARN of the ECS cluster.
* `--dry-run` - Perform a dry run: Show what will be done, but don't change ECS.
* `--log-format string` - Set to `color`, `plain`, or `json` to control the log format.
* `--profile string` - Which of the AWS profiles to use to access ECS.
* `--project string` - The Postman Insights project ID.
* `--proxy string` - The domain name, IP address, or URL of an HTTP proxy server to use.
* `--region string` - The AWS region in which the ECS cluster resides.
* `--service string` - The name or ARN of the ECS service.
* `--task string` - The name of the ECS task definition to change.