New-​Azure​Rm​Scheduler​Http​Job

Creates an HTTP job.

Syntax

New-AzureRmSchedulerHttpJob
   [-EndTime <DateTime>]
   [-ErrorActionType <String>]
   [-ExecutionCount <Int32>]
   [-Frequency <String>]
   [-Headers <Hashtable>]
   [-HttpAuthenticationType <String>]
   [-Interval <Int32>]
   -JobCollectionName <String>
   -JobName <String>
   [-JobState <String>]
   -Method <String>
   [-RequestBody <String>]
   -ResourceGroupName <String>
   [-StartTime <DateTime>]
   -Uri <Uri>
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

The New-AzureRmSchedulerHttpJob cmdlet creates an HTTP job in Azure Scheduler.

This cmdlet supports dynamic parameters based on the ErrorActionType and HttpAuthenticationType parameters. Dynamic parameters become available based on other parameter values.

To discover the names of dynamic parameters after you specify the other parameters, type a hyphen (-), and then press the Tab key repeatedly to cycle through the available parameters. If you omit a required parameter, the cmdlet prompts you for the value.

Examples

1:

Required Parameters

-JobCollectionName

Specifies the name of the job collection to which the job belongs.

Type:String
Aliases:Name, ResourceName
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-JobName

Specifies a name for the job.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Method

Specifies the method for the action types for the job. The acceptable values for this parameter are:

  • GET
  • PUT
  • POST
  • DELETE
Type:String
Parameter Sets:GET, PUT, POST, DELETE
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ResourceGroupName

Specifies the resource group to which the job belongs.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Uri

Specifies a URI for the job action.

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

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-EndTime

Specifies an end time, as a DateTime object, for the job. To obtain a DateTime object, use the Get-Date cmdlet.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ErrorActionType

Specifies an error action setting for the job. The acceptable values for this parameter are:

  • Http
  • Https
  • StorageQueue
  • ServiceBusQueue
  • ServiceBusTopic
Type:String
Parameter Sets:Http, Https, StorageQueue, ServiceBusQueue, ServiceBusTopic
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ExecutionCount

Specifies how many times the job runs. By default, a job recurs indefinitely.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Frequency

Specifies a maximum frequency for the job. The acceptable values for this parameter are:

  • Minute
  • Hour
  • Day
  • Week
  • Month
Type:String
Parameter Sets:Minute, Hour, Day, Week, Month
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Headers

Specifies a hash table that contains headers.

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-HttpAuthenticationType

Specifies the HTTP authentication type. The acceptable values for this parameter are:

  • None
  • ClientCertificate
  • ActiveDirectoryOAuth
  • Basic
Type:String
Parameter Sets:None, ClientCertificate, ActiveDirectoryOAuth, Basic
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Interval

Specifies an interval of recurrence for the job.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-JobState

Specifies the state of the job. The acceptable values for this parameter are:

  • Enabled
  • Disabled
Type:String
Parameter Sets:Enabled, Disabled
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-RequestBody

Specifies the value of the body for PUT and POST job actions.

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

Specifies the start time, as a DateTime object, for the job.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False