Specifies whether an INSERT operation should perform an upsert by checking the ExternalId.

Syntax

Connect-NetSuite -UseUpserts SwitchParameter

Data Type

bool

Default Value

false

Remarks

When this property is set to true, INSERT operations check for an existing record using the ExternalId field:

• If the specified ExternalId already exists in NetSuite, the existing record is updated.
• If the ExternalId does not exist, a new record is created.

When this property is set to false, INSERT operations always attempt to create a new record. If a record with the specified ExternalId already exists, the operation fails with a "This record already exists" error. The record is not updated, even if ExternalId matches an existing one.

This property applies only when Schema is set to SuiteTalk.