Cmdlet

Get-OfficeProvenance

Module: PSWriteOffice
Inputs: System.String
Outputs: OfficeIMO.Provenance.OfficeProvenanceAssessmentReport
Source: GetOfficeProvenanceCommand.cs:25 Edit on GitHub

Collects structural, text-integrity, and optional provider verification evidence for a file.

Syntax

Get-OfficeProvenance
[-C2paToolPath <String>]
[-Options <OfficeProvenanceAssessmentOptions>]
[-Path] <String>
[-SignalDetector <IOfficeProvenanceSignalDetector[]>]
[<CommonParameters>]

Parameter set: All Parameter Sets

Description

The result keeps carrier discovery, cryptographic verification, and provider signals separate; it does not infer authorship from their presence or absence.

Examples

Inspect embedded provenance without invoking an external verifier.

$evidence = Get-OfficeProvenance -Path .\Published\cover.png
$evidence.Structural | Select-Object Format, HasC2paManifest
$evidence.TextIntegrity

Ask an explicitly supplied c2patool installation to verify Content Credentials.

$evidence = Get-OfficeProvenance -Path .\Published\cover.png -C2paToolPath C:\Tools\c2patool.exe
$evidence.Verification | Select-Object Status, ProviderName, Findings

Network access remains disabled unless enabled in the supplied assessment options.

Parameters

-C2paToolPath String optional: Explicit c2patool executable path or controlled command name used for cryptographic verification.
-Options OfficeProvenanceAssessmentOptions optional: Structural, text-integrity, and provider verification limits and policy.
-Path String requiredposition: 0pipeline: True (ByValue)aliases: FilePath: Asset or document path to inspect.
-SignalDetector IOfficeProvenanceSignalDetector[] optional: Optional provider-specific watermark or disclosure detectors.

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.