delete
Delete records from a Dataverse entity
Usage
ppds data delete [options]
Options
| Long | Short | Type | Default | Description |
|---|---|---|---|---|
--batch-size | int | Records per batch (default: 100) | ||
--bypass-flows | bool | Bypass Power Automate flow triggers | ||
--bypass-plugins | string | Bypass custom plugin execution: sync, async, or all (requires prvBypassCustomBusinessLogic privilege) | ||
--continue-on-error | bool | Continue deleting on individual record failures | ||
--correlation-id | string | Correlation ID for distributed tracing | ||
--debug | bool | Show trace-level diagnostic output | ||
--dry-run | bool | Preview records that would be deleted without actually deleting | ||
--entity | -e | string | Target entity logical name | |
--environment | -env | string | Override the environment URL. Takes precedence over profile's bound environment. | |
--file | FileInfo | Path to file containing record IDs (JSON array or CSV with ID column) | ||
--filter | string | SQL-like filter expression to match records for deletion (e.g., "name like '%test%'") | ||
--force | bool | Skip confirmation prompt (required for non-interactive execution) | ||
--id | Guid? | Record ID (GUID) to delete | ||
--id-column | string | Column name containing record IDs in CSV file (default: entity primary key) | ||
--key | -k | string | Alternate key field(s) for lookup. Format: field=value or field1=value1,field2=value2 for composite keys. | |
--limit | int? | Maximum number of records to delete (fails if query returns more) | ||
--output-format | -f | OutputFormat | Output format | |
--profile | -p | string | Profile name(s). For high-throughput pooling, specify multiple Application User profiles comma-separated (e.g., app1,app2,app3) - each profile multiplies API quota. | |
--quiet | -q | bool | Show only warnings and errors | |
--verbose | -v | bool | Show detailed output including debug messages |