Skip to main content

import

Import data from a ZIP file into Dataverse

Usage​

ppds data import [options]

Options​

LongShortTypeDefaultDescription
--bypass-flowsboolBypass Power Automate flow triggers (no special privilege required)
--bypass-pluginsstringBypass custom plugin execution: sync, async, or all (requires prvBypassCustomBusinessLogic privilege)
--continue-on-errorboolContinue import on individual record failures
--data-dFileInfoPath to data.zip file
--debugboolEnable diagnostic logging output
--environment-envstringOverride the environment URL. Takes precedence over profile's bound environment.
--error-reportFileInfoBase path for output files (creates .errors.jsonl, .progress.log, .summary.json). Errors are streamed in real-time.
--impersonate-ownersboolPreserve record ownership via CallerAADObjectId impersonation (requires --user-mapping)
--mode-mImportModeImport mode: Create, Update, or Upsert
--output-format-fOutputFormatOutput format
--profile-pstringProfile name(s). For high-throughput pooling, specify multiple Application User profiles comma-separated (e.g., app1,app2,app3) - each profile multiplies API quota.
--resolve-lookupsboolEnable external lookup resolution (ID check, then name-based query)
--skip-missing-columnsboolSkip columns that exist in exported data but not in target environment (prevents schema mismatch errors)
--skip-unresolved-lookupsboolNull unresolved lookups instead of failing the record [default: True] (requires --resolve-lookups)
--strip-owner-fieldsboolStrip ownership fields (ownerid, createdby, modifiedby) allowing Dataverse to assign current user
--user-mapping-uFileInfoPath to user mapping XML file for remapping user references
--verbose-vboolEnable verbose logging output