Cmdlet
Set-OfficeExcelExecutionPolicy
Configures OfficeIMO Excel execution and validation behavior for a workbook.
Syntax
Set-OfficeExcelExecutionPolicy [-Diagnostics] [-DisableAutoFitImmediateSave] [-MaxDegreeOfParallelism <Int32>] [-Mode <Automatic|Sequential|Parallel>] [-ParallelThreshold <Int32>] [-PassThru] [-WorksheetValidation <Disabled|DiagnosticsOnly|DebugOnly|Always>] [<CommonParameters>]#Parameter set:
ContextSet-OfficeExcelExecutionPolicy [-Diagnostics] [-DisableAutoFitImmediateSave] [-Document] <ExcelDocument> [-MaxDegreeOfParallelism <Int32>] [-Mode <Automatic|Sequential|Parallel>] [-ParallelThreshold <Int32>] [-PassThru] [-WorksheetValidation <Disabled|DiagnosticsOnly|DebugOnly|Always>] [<CommonParameters>]#Parameter set:
DocumentExamples
Force sequential execution for a workbook.
$workbook | Set-OfficeExcelExecutionPolicy -Mode SequentialDisables automatic parallel execution decisions for subsequent OfficeIMO operations.
Parameters
- -Diagnostics SwitchParameter
- Request diagnostics-aware validation without wiring verbose callbacks.
- -DisableAutoFitImmediateSave SwitchParameter
- Do not save worksheet parts immediately after AutoFit width/height mutations.
- -MaxDegreeOfParallelism Int32
- Optional cap for parallel compute phases.
- -Mode ExcelExecutionMode
- Execution mode for large operations.
- Possible values:
Automatic,Sequential,Parallel - -ParallelThreshold Int32
- Global item threshold above which Automatic mode switches to Parallel.
- -PassThru SwitchParameter
- Emit the workbook after updating the policy.
- -WorksheetValidation ExcelWorksheetValidationMode
- Worksheet validation mode for write operations.
- Possible values:
Disabled,DiagnosticsOnly,DebugOnly,Always - -Document ExcelDocument
- Workbook whose execution policy should be updated.
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.