# Get-TaskSchedule Returns one or more task schedule items using the specified criteria. ## Syntax Get-TaskSchedule -Item \ Get-TaskSchedule -Path \ Get-TaskSchedule \[\[-Database] \] \[\[-Name] \] ## Detailed Description The Get-TaskSchedule command returns one or more task schedule items, based on name/database filter, path or simply converting a Sitecore item. © 2010-2019 Adam Najmanowicz, Michael West. All rights reserved. Sitecore PowerShell Extensions ## Parameters ### -Item \ Task item to be converted. | Aliases | | | --------------------------- | ------------------------------ | | Required? | true | | Position? | named | | Default Value | | | Accept Pipeline Input? | true (ByValue, ByPropertyName) | | Accept Wildcard Characters? | false | ### -Path \ Path to the item to be returned as Task Schedule. | Aliases | | | --------------------------- | ------------------------------ | | Required? | true | | Position? | named | | Default Value | | | Accept Pipeline Input? | true (ByValue, ByPropertyName) | | Accept Wildcard Characters? | false | ### -Database \ Database containing the task items to be returned. If not provided all databases will be considered for filtering using the "Name" parameter. | Aliases | | | --------------------------- | -------------- | | Required? | false | | Position? | 2 | | Default Value | | | Accept Pipeline Input? | true (ByValue) | | Accept Wildcard Characters? | false | ### -Name \ Task filter - supports wildcards. Works with "Database" parameter to narrow tassk to only single database. | Aliases | | | --------------------------- | ----- | | Required? | false | | Position? | 1 | | Default Value | | | Accept Pipeline Input? | false | | Accept Wildcard Characters? | false | ## Inputs The input type is the type of the objects that you can pipe to the cmdlet. * Sitecore.Data.Items.Item ## Outputs The output type is the type of the objects that the cmdlet emits. * Sitecore.Tasks.ScheduleItem ## Notes Help Author: Adam Najmanowicz, Michael West ## Examples ### EXAMPLE 1 ```powershell PS master:\> Get-TaskSchedule Name Database Active Auto Remove Is Due Expired Completed Last Run Next Run ---- -------- ------ ----------- ------ ------- --------- -------- -------- __Task Schedule master True False True False False 0001-01-01 00:00:00 0001-01-01 00:00:00 Check Bounced Messages master True False False False False 2014-07-29 10:18:43 2014-07-29 22:48:43 Check DSN Messages master True False False False False 2014-07-29 10:19:18 2014-07-29 22:49:18 Clean Confirmation IDs master True False False False False 2014-07-28 22:14:30 2014-07-31 02:14:30 Clean Message History master True False False False False 2014-07-29 10:19:18 2014-07-29 22:49:18 Close Outdated Connections master True False False False False 2014-07-29 12:30:22 2014-07-29 13:30:22 Test-PowerShell master True False False False False 2014-07-28 14:30:06 2014-08-01 17:32:07 __Task Schedule web True False True False False 0001-01-01 00:00:00 0001-01-01 00:00:00 Check Bounced Messages web True False True False False 2013-11-04 08:36:22 2013-11-04 21:06:22 Check DSN Messages web True False True False False 2013-11-04 08:36:22 2013-11-04 21:06:22 Clean Confirmation IDs web True False False False False 2013-11-04 08:36:22 2013-11-04 21:36:22 Clean Message History web True False True False False 2013-11-04 08:36:22 2013-11-04 21:06:22 Close Outdated Connections web True False True False False 2013-11-04 09:36:23 2013-11-04 10:36:23 Test-PowerShell web True False True False False 2013-11-04 09:46:29 2013-11-04 09:46:30 ``` ### EXAMPLE 2 ```powershell PS master:\> Get-TaskSchedule -Name "*Check*" Name Database Active Auto Remove Is Due Expired Completed Last Run Next Run ---- -------- ------ ----------- ------ ------- --------- -------- -------- Check Bounced Messages master True False False False False 2014-07-29 10:18:43 2014-07-29 22:48:43 Check DSN Messages master True False False False False 2014-07-29 10:19:18 2014-07-29 22:49:18 Check Bounced Messages web True False True False False 2013-11-04 08:36:22 2013-11-04 21:06:22 Check DSN Messages web True False True False False 2013-11-04 08:36:22 2013-11-04 21:06:22 ``` ### EXAMPLE 3 ```powershell PS master:\> Get-TaskSchedule -Name "*Check*" -Database "master" Name Database Active Auto Remove Is Due Expired Completed Last Run Next Run ---- -------- ------ ----------- ------ ------- --------- -------- -------- Check Bounced Messages master True False False False False 2014-07-29 10:18:43 2014-07-29 22:48:43 Check DSN Messages master True False False False False 2014-07-29 10:19:18 2014-07-29 22:49:18 ``` ## Related Topics * [Start-TaskSchedule](/appendix/common/start-taskschedule.md) * * --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://doc.sitecorepowershell.com/appendix/common/get-taskschedule.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.