About Help

Choose a topic from the list on the left or search for a specific topic. Choose a topic from the list or search for a specific topic.
Cmdlets  Providers  Aliases  Modules
 

about_SPTimerJobState

Sptimerjobstate

SharePointDSC
 

SHORT DESCRIPTION

 

.NAME

    SPTimerJobState 
 
# Description 
     
    This resource is used to configure a timer job and make sure it is in a 
    specific state. The resource can be used to enable or disabled the job and 
    configure the schedule of the job. 
     
    The schedule parameter has to be written in the SPSchedule format 
    (https://technet.microsoft.com/en-us/library/ff607916.aspx). 
     
    Examples are: 
     
    - Every 5 minutes between 0 and 59 
    - Hourly between 0 and 59 
    - Daily at 15:00:00 
    - Weekly between Fri 22:00:00 and Sun 06:00:00 
    - Monthly at 15 15:00:00 
    - Yearly at Jan 1 15:00:00 
     
    NOTE: Make sure you use the internal timer job name, not the display name! Use 
    "Get-SPTimerJob -WebApplication "http://servername" | select Name, DisplayName" 
    to find the internal name for each Timer Job. 
     
.PARAMETER Name 
    Key - String 
    The internal name of the timer job (not the display name) 
 
.PARAMETER WebApplication 
    Write - String 
    The name of the web application that the timer job belongs to 
 
.PARAMETER Enabled 
    Write - Boolean 
    Should the timer job be enabled or not 
 
.PARAMETER Schedule 
    Write - String 
    The schedule for the timer job to execute on 
 
.PARAMETER InstallAccount 
    Write - String 
    POWERSHELL 4 ONLY: The account to run this resource as, use PsDscRunAsCredential if using PowerShell 5 
 
 

.EXAMPLE

    This example show how to disable the dead site delete job in the local farm. 
 
 
    Configuration Example  
    { 
        param( 
            [Parameter(Mandatory = $true)] 
            [PSCredential] 
            $SetupAccount 
        ) 
        Import-DscResource -ModuleName SharePointDsc 
 
        node localhost { 
            SPTimerJobState DisableTimerJob_DeadSiteDelete 
            { 
                Name                    = "job-dead-site-delete" 
                WebApplication          = "http://sites.sharepoint.contoso.com" 
                Enabled                 = $false 
                Schedule                ="weekly at sat 5:00" 
                PsDscRunAsCredential    = $SetupAccount 
            } 
        } 
    }