Skip to content

Get PpacD365OperationHistory

FH-Inway edited this page Sep 17, 2026 · 1 revision

external help file: d365bap.tools-help.xml Module Name: d365bap.tools online version: schema: 2.0.0

Get-PpacD365OperationHistory

SYNOPSIS

Get operation history for a given Unified environment from PPAC.

SYNTAX

Get-PpacD365OperationHistory [-EnvironmentId] <String> [-LatestOnly] [[-Id] <String>] [-DownloadLog]
 [[-DownloadPath] <String>] [-AsExcelOutput] [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

Retrieves the operation history for a specified Unified environment from the Power Platform Admin Center (PPAC). This includes details such as operation name, description, correlation ID, status, and more.

EXAMPLES

EXAMPLE 1

Get-PpacD365OperationHistory -EnvironmentId "eec2c11a-a4c7-4e1d-b8ed-f62acc9c74c6"

This will fetch the operation history for the specified environment.

EXAMPLE 2

Get-PpacD365OperationHistory -EnvironmentId "eec2a-a4c7-4e1d-b8ed-f62acc9c74c6" -LatestOnly

This will fetch only the latest operation from the operation history for the specified environment.

EXAMPLE 3

Get-PpacD365OperationHistory -EnvironmentId "eec2a-a4c7-4e1d-b8ed-f62acc9c74c6" -AsExcelOutput

This will fetch the operation history for the specified environment. It will output the results directly into an Excel file, that will automatically open on your machine.

EXAMPLE 4

Get-PpacD365OperationHistory -EnvironmentId "eec2a-a4c7-4e1d-b8ed-f62acc9c74c6" -DownloadLog

This will fetch the operation history for the specified environment. It will attempt to download the operation logs for each operation in the history, and save them to the default download path.

EXAMPLE 5

Get-PpacD365OperationHistory -EnvironmentId "eec2a-a4c7-4e1d-b8ed-f62acc9c74c6" -DownloadLog -DownloadPath "C:\Temp\MyLogs"

This will fetch the operation history for the specified environment. It will attempt to download the operation logs for each operation in the history, and save them to "C:\Temp\MyLogs".

EXAMPLE 6

Get-PpacD365OperationHistory -EnvironmentId "eec2a-a4c7-4e1d-b8ed-f62acc9c74c6" -Id "a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6"

This will fetch the operation history for the specified environment. It will filter the results to only include the operation with the specified id.

PARAMETERS

-EnvironmentId

The id of the environment that you want to work against.

Can be either the environment name, the environment GUID (PPAC) or the LCS environment ID.

Type: String
Parameter Sets: (All)
Aliases: PpacEnvId

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-LatestOnly

Instructs the cmdlet to only return the latest operation from the history.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Id

The id of the operation history entry that you want to retrieve.

The value is converted to lower case prior filtering.

Supports wildcard characters for flexible matching against the operation history id.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: *
Accept pipeline input: False
Accept wildcard characters: False

-DownloadLog

Instructs the cmdlet to attempt to download the operation logs for each operation in the history.

Note that not all operations will have logs available, and for some operations (e.g. FnO DB Sql Jit) there are no logs at all.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-DownloadPath

Specifies the path where the downloaded logs will be saved.

The default path is "C:\Temp\d365bap.tools\PpacD365OperationHistory".

Logs will be organized in subfolders for each environment based on the environment name.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: C:\Temp\d365bap.tools\PpacD365OperationHistory
Accept pipeline input: False
Accept wildcard characters: False

-AsExcelOutput

Instructs the cmdlet to output the results as an Excel file.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ProgressAction

{{ Fill ProgressAction Description }}

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

System.Object[]

NOTES

Author: Mötz Jensen (@Splaxi)

RELATED LINKS

Clone this wiki locally