--- title: "Start-DbaAgentJob" description: "Starts SQL Server Agent jobs and optionally waits for completion" url: "https://dbatools.io/Start-DbaAgentJob/" availability: "Windows, Linux, macOS" tags: ["Job", "Agent"] author: "Chrissy LeMaire (@cl), netnerds.net" source: "https://github.com/dataplat/dbatools/blob/master/public/Start-DbaAgentJob.ps1" last_updated: "2024-01-01" --- # Start-DbaAgentJob ## Synopsis Starts SQL Server Agent jobs and optionally waits for completion ## Description Starts one or more SQL Server Agent jobs that are currently idle. This function validates jobs are in an idle state before starting them and can optionally wait for job completion before returning results. You can start all jobs, specific jobs by name, or exclude certain jobs from execution. It also supports starting jobs at specific steps rather than from the beginning, which is useful for resuming failed jobs or testing individual job steps. ## Syntax ```powershell Start-DbaAgentJob [-SqlCredential ] [-Job ] [-StepName ] [-ExcludeJob ] [-AllJobs] [-Wait] [-Parallel] [-WaitPeriod ] [-SleepPeriod ] [-EnableException] [-WhatIf] [-Confirm] [] Start-DbaAgentJob -SqlInstance [-SqlCredential ] [-Job ] [-StepName ] [-ExcludeJob ] [-AllJobs] [-Wait] [-Parallel] [-WaitPeriod ] [-SleepPeriod ] [-EnableException] [-WhatIf] [-Confirm] [] Start-DbaAgentJob [-SqlCredential ] [-Job ] [-StepName ] [-ExcludeJob ] -InputObject [-AllJobs] [-Wait] [-Parallel] [-WaitPeriod ] [-SleepPeriod ] [-EnableException] [-WhatIf] [-Confirm] [] ``` ## Examples ### Example 1: Starts all running SQL Agent Jobs on the local SQL Server instance ```powershell PS C:\> Start-DbaAgentJob -SqlInstance localhost ``` ### Example 2: Starts the cdc.DBWithCDC_capture SQL Agent Job on sql2016 ```powershell PS C:\> Get-DbaAgentJob -SqlInstance sql2016 -Job cdc.DBWithCDC_capture | Start-DbaAgentJob ``` ### Example 3: Starts the cdc.DBWithCDC_capture SQL Agent Job on sql2016 ```powershell PS C:\> Start-DbaAgentJob -SqlInstance sql2016 -Job cdc.DBWithCDC_capture ``` ### Example 4: Restarts all failed jobs on all servers in the $servers collection ```powershell PS C:\> $servers | Find-DbaAgentJob -IsFailed | Start-DbaAgentJob ``` ### Example 5: Start all the jobs ```powershell PS C:\> Start-DbaAgentJob -SqlInstance sql2016 -AllJobs ``` ### Example 6: This is a serialized approach to submitting jobs and waiting for each job to continue the next ```powershell PS C:\> Start-DbaAgentJob -SqlInstance sql2016 -Job @('Job1', 'Job2', 'Job3') -Wait ``` This is a serialized approach to submitting jobs and waiting for each job to continue the next. Starts Job1, waits for completion of Job1 Starts Job2, waits for completion of Job2 Starts Job3, Waits for completion of Job3 ### Example 7: This is a parallel approach to submitting all jobs and waiting for them all to complete ```powershell PS C:\> Start-DbaAgentJob -SqlInstance sql2016 -Job @('Job1', 'Job2', 'Job3') -Wait -Parallel ``` This is a parallel approach to submitting all jobs and waiting for them all to complete. Starts Job1, starts Job2, starts Job3 and waits for completion of Job1, Job2, and Job3. ### Example 8: Starts the JobWith5Steps SQL Agent Job at step Step4 ```powershell PS C:\> Start-DbaAgentJob -SqlInstance sql2016 -Job JobWith5Steps -StepName Step4 ``` ### Required Parameters ##### -SqlInstance The target SQL Server instance or instances. | Property | Value | | --- | --- | | Alias | | | Required | True | | Pipeline | false | | Default Value | | ##### -InputObject Accepts SQL Agent job objects from the pipeline, typically from Get-DbaAgentJob or other dbatools functions. Use this when chaining dbatools commands together to start jobs that meet specific criteria, such as failed jobs or jobs with certain schedules. | Property | Value | | --- | --- | | Alias | | | Required | True | | Pipeline | true (ByValue) | | Default Value | | ### Optional Parameters ##### -SqlCredential Login to the target instance using alternative credentials. Accepts PowerShell credentials (Get-Credential). Windows Authentication, SQL Server Authentication, Active Directory - Password, and Active Directory - Integrated are all supported. For MFA support, please use Connect-DbaInstance. | Property | Value | | --- | --- | | Alias | | | Required | False | | Pipeline | false | | Default Value | | ##### -Job Specifies the names of specific SQL Agent jobs to start. Accepts job names as strings and supports multiple job names in an array. Use this when you need to start only certain jobs instead of all jobs on the server. Job names are case-sensitive and must match exactly. | Property | Value | | --- | --- | | Alias | | | Required | False | | Pipeline | false | | Default Value | | ##### -StepName Specifies the job step name where job execution should begin instead of starting from the first step. Use this to resume a failed job at a specific step or to test individual job steps without running the entire job sequence. | Property | Value | | --- | --- | | Alias | | | Required | False | | Pipeline | false | | Default Value | | ##### -ExcludeJob Specifies job names to exclude from starting when using -AllJobs or when no specific jobs are specified. Use this to start all jobs except certain ones, such as excluding maintenance jobs during business hours or problematic jobs that need special handling. | Property | Value | | --- | --- | | Alias | | | Required | False | | Pipeline | false | | Default Value | | ##### -AllJobs Starts all SQL Agent jobs that are currently in an idle state on the target instance. Use this switch when you need to start all available jobs, typically after server maintenance or during bulk job execution scenarios. | Property | Value | | --- | --- | | Alias | | | Required | False | | Pipeline | false | | Default Value | False | ##### -Wait Waits for each job to complete execution before returning results or proceeding to the next job. Use this when you need to ensure job completion before continuing your script, or when jobs have dependencies that require sequential execution. | Property | Value | | --- | --- | | Alias | | | Required | False | | Pipeline | false | | Default Value | False | ##### -Parallel Starts all specified jobs simultaneously and waits for all to complete, rather than starting and waiting for each job sequentially. Use this when jobs can run concurrently without conflicts to reduce total execution time. Requires the -Wait parameter to function. | Property | Value | | --- | --- | | Alias | | | Required | False | | Pipeline | false | | Default Value | False | ##### -WaitPeriod Sets the polling interval in seconds for checking job status when using the -Wait parameter. Defaults to 3 seconds. Adjust this value based on your job duration - use shorter intervals for quick jobs or longer intervals for jobs that run for hours to reduce server load. | Property | Value | | --- | --- | | Alias | | | Required | False | | Pipeline | false | | Default Value | 3 | ##### -SleepPeriod Sets the initial wait time in milliseconds after starting a job before checking its status. Defaults to 300 milliseconds. Increase this value if you experience issues with jobs not showing as started immediately, which can occur on heavily loaded servers. | Property | Value | | --- | --- | | Alias | | | Required | False | | Pipeline | false | | Default Value | 300 | ##### -EnableException By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message. This avoids overwhelming you with "sea of red" exceptions, but is inconvenient because it basically disables advanced scripting. Using this switch turns this "nice by default" feature off and enables you to catch exceptions with your own try/catch. | Property | Value | | --- | --- | | Alias | | | Required | False | | Pipeline | false | | Default Value | False | ##### -WhatIf If this switch is enabled, no actions are performed but informational messages will be displayed that explain what would happen if the command were to run. | Property | Value | | --- | --- | | Alias | wi | | Required | False | | Pipeline | false | | Default Value | | ##### -Confirm If this switch is enabled, you will be prompted for confirmation before executing any operations that change state. | Property | Value | | --- | --- | | Alias | cf | | Required | False | | Pipeline | false | | Default Value | | ## Outputs **Microsoft.SqlServer.Management.Smo.Agent.Job** Returns one SQL Server Agent Job object per job started. Job objects are returned from Get-DbaAgentJob after the job execution completes (when -Wait is specified) or immediately after starting (without -Wait). **Default display properties (via Select-DefaultView):** - ComputerName: The name of the computer hosting the SQL Server instance - InstanceName: The SQL Server instance name - SqlInstance: The full SQL Server instance name (computer\instance) - Name: The name of the SQL Agent job - CurrentRunStatus: The current execution status of the job (Idle, Executing, etc.) - LastRunDate: DateTime of the most recent job execution - LastRunOutcome: Outcome of the last run (Succeeded, Failed, Cancelled, etc.) - IsEnabled: Boolean indicating if the job is enabled - HasSchedule: Boolean indicating if the job has schedules - OwnerLoginName: Login that owns the job **Additional properties available (from SMO Agent.Job object):** - JobSteps: Collection of job steps defined in this job - Schedules: Collection of schedules assigned to this job - Notifications: Notification settings for the job - Category: The job category name - CategoryID: The job category ID - CreatedDate: DateTime when the job was created - Description: Job description text Note: When using sequential processing without -Wait, jobs start but the command returns after they begin. When using -Wait (sequential or parallel), the command waits for job completion before returning results. --- Part of [dbatools](https://dbatools.io/), a free and open source PowerShell module for SQL Server administration. Full command index: https://dbatools.io/commands/