Get-AzSynapsePipelineRun

  • Reference
Module:
Az.Synapse

Gets information about pipeline runs.

Syntax

Get-AzSynapsePipelineRun
   -WorkspaceName <String>
   -PipelineRunId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzSynapsePipelineRun
   -WorkspaceName <String>
   -RunStartedAfter <DateTimeOffset>
   -RunStartedBefore <DateTimeOffset>
   [-PipelineName <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzSynapsePipelineRun
   -WorkspaceObject <PSSynapseWorkspace>
   -PipelineRunId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzSynapsePipelineRun
   -WorkspaceObject <PSSynapseWorkspace>
   -RunStartedAfter <DateTimeOffset>
   -RunStartedBefore <DateTimeOffset>
   [-PipelineName <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

The Get-AzSynapsePipelineRun command returns information about runs for the specified pipeline. If PipelineRunId is specified, it shows details for the run with that ID. If the PipelineRunId is not specified, then it shows information about all runs for the pipelines that happened between the values of RunStartedAfter and RunStartedBefore.

Examples

Example 1: Get pipeline run by ID

Get-AzSynapsePipelineRun -WorkspaceName ContosoWorkspace -PipelineRunId "61eb095a-fe23-4591-8a97-fade6c65ca72"

This command gets details about the pipeline run with ID "61eb095a-fe23-4591-8a97-fade6c65ca72".

Example 2: Get pipelines runs between the dates

$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | Get-AzSynapsePipelineRun -RunStartedAfter "4/2/2007 7:23:57 PM" -RunStartedBefore "4/2/2027 7:23:57 PM"

This command gets details about the runs of all pipelines in the workspace ContosoWorkspace that started between "4/2/2007 7:23:57 PM" and "4/2/2027 7:23:57 PM"

Example 3: Get a single pipeline runs between the dates

Get-AzSynapsePipelineRun -WorkspaceName ContosoWorkspace -PipelineName ContosoPipeline -RunStartedAfter "4/2/2007 7:23:57 PM" -RunStartedBefore "4/2/2027 7:23:57 PM"

This command gets details about the runs of ContosoPipeline pipeline in the workspace ContosoWorkspace that started between "4/2/2007 7:23:57 PM" and "4/2/2027 7:23:57 PM"

Parameters

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PipelineName

The pipeline name.

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

-PipelineRunId

The pipeline run identifier.

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

-RunStartedAfter

The time at or after which the run event was updated in 'ISO 8601' format.

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

-RunStartedBefore

The time at or before which the run event was updated in 'ISO 8601' format.

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

-WorkspaceName

Name of Synapse workspace.

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

-WorkspaceObject

workspace input object, usually passed through the pipeline.

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

Inputs

PSSynapseWorkspace

Outputs

PSPipelineRun