< Back
New-JenkinsJob
Post
NAME New-JenkinsJob
SYNOPSIS
Create a new Jenkins Job.
SYNTAX
New-JenkinsJob [-Uri] <String> [[-Credential] <PSCredential>] [[-Crumb] <String>] [[-Folder] <String>] [-Name]
<String> [-XML] <String> [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Creates a new Jenkins Job using the provided XML. If a folder is specified it will create the job in the specified
folder. If the job already exists an error will occur.
PARAMETERS
-Uri <String>
Contains the Uri to the Jenkins Master server to set the Job definition on.
Required? true
Position? 2
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Credential <PSCredential>
Contains the credentials to use to authenticate with the Jenkins Master server.
Required? false
Position? 3
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Crumb <String>
Contains a Crumb to pass to the Jenkins Master Server if CSRF is enabled.
Required? false
Position? 4
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Folder <String>
The optional job folder the job is in. This requires the Jobs Plugin to be installed on Jenkins. If the folder
does not exist then an error will occur.
Required? false
Position? 5
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
The name of the job to add.
Required? true
Position? 6
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-XML <String>
The config XML of the job to import.
Required? true
Position? 7
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
None.
NOTES
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>New-JenkinsJob `
-Uri 'https://jenkins.contoso.com' \\`
-Credential (Get-Credential) \\`
-Name 'My App Build' \\`
-XML $MyAppBuildConfig \\`
-Verbose
Sets the job definition of the 'My App Build' job on https://jenkins.contoso.com using the credentials provided by
the user.
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>New-JenkinsJob `
-Uri 'https://jenkins.contoso.com' \\`
-Credential (Get-Credential) \\`
-Folder 'Misc' \\`
-Name 'My App Build' \\`
-XML $MyAppBuildConfig \\`
-Verbose
Sets the job definition of the 'My App Build' job in the 'Misc' folder on https://jenkins.contoso.com using the
credentials provided by the user.
RELATED LINKS
SYNOPSIS
Create a new Jenkins Job.
SYNTAX
New-JenkinsJob [-Uri] <String> [[-Credential] <PSCredential>] [[-Crumb] <String>] [[-Folder] <String>] [-Name]
<String> [-XML] <String> [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Creates a new Jenkins Job using the provided XML. If a folder is specified it will create the job in the specified
folder. If the job already exists an error will occur.
PARAMETERS
-Uri <String>
Contains the Uri to the Jenkins Master server to set the Job definition on.
Required? true
Position? 2
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Credential <PSCredential>
Contains the credentials to use to authenticate with the Jenkins Master server.
Required? false
Position? 3
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Crumb <String>
Contains a Crumb to pass to the Jenkins Master Server if CSRF is enabled.
Required? false
Position? 4
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Folder <String>
The optional job folder the job is in. This requires the Jobs Plugin to be installed on Jenkins. If the folder
does not exist then an error will occur.
Required? false
Position? 5
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
The name of the job to add.
Required? true
Position? 6
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-XML <String>
The config XML of the job to import.
Required? true
Position? 7
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
None.
NOTES
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>New-JenkinsJob `
-Uri 'https://jenkins.contoso.com' \\`
-Credential (Get-Credential) \\`
-Name 'My App Build' \\`
-XML $MyAppBuildConfig \\`
-Verbose
Sets the job definition of the 'My App Build' job on https://jenkins.contoso.com using the credentials provided by
the user.
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>New-JenkinsJob `
-Uri 'https://jenkins.contoso.com' \\`
-Credential (Get-Credential) \\`
-Folder 'Misc' \\`
-Name 'My App Build' \\`
-XML $MyAppBuildConfig \\`
-Verbose
Sets the job definition of the 'My App Build' job in the 'Misc' folder on https://jenkins.contoso.com using the
credentials provided by the user.
RELATED LINKS