你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzureSchedulerHttpJob

模块:

Azure

创建具有 HTTP 操作的计划程序作业。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

New-AzureSchedulerHttpJob
   -Location <String>
   -JobCollectionName <String>
   -JobName <String>
   -Method <String>
   -URI <Uri>
   [-RequestBody <String>]
   [-StartTime <DateTime>]
   [-Interval <Int32>]
   [-Frequency <String>]
   [-ExecutionCount <Int32>]
   [-EndTime <DateTime>]
   [-JobState <String>]
   [-Headers <Hashtable>]
   [-ErrorActionMethod <String>]
   [-ErrorActionURI <Uri>]
   [-ErrorActionRequestBody <String>]
   [-ErrorActionHeaders <Hashtable>]
   [-ErrorActionStorageAccount <String>]
   [-ErrorActionStorageQueue <String>]
   [-ErrorActionSASToken <String>]
   [-ErrorActionQueueMessageBody <String>]
   [-HttpAuthenticationType <String>]
   [-ClientCertificatePfx <Object>]
   [-ClientCertificatePassword <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

New-AzureSchedulerHttpJob
   [-RequestBody <String>]
   [-JobState <String>]
   [-Headers <Hashtable>]
   [-ErrorActionHeaders <Hashtable>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

New-AzureSchedulerHttpJob
   [-Interval <Int32>]
   [-Frequency <String>]
   [-ExecutionCount <Int32>]
   [-EndTime <DateTime>]
   [-JobState <String>]
   [-Headers <Hashtable>]
   [-ErrorActionHeaders <Hashtable>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

New-AzureSchedulerHttpJob
   [-JobState <String>]
   [-Headers <Hashtable>]
   [-ErrorActionHeaders <Hashtable>]
   -HttpAuthenticationType <String>
   [-ClientCertificatePfx <Object>]
   [-ClientCertificatePassword <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

说明

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本，请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version。

New-AzureSchedulerHttpJob cmdlet 创建具有 HTTP 操作的计划程序作业。

示例

示例 1：创建 HTTP 作业

PS C:\> New-AzureSchedulerHttpJob -JobCollectionName "JobCollection01" -JobName "Job01" -Location "North Central US" -Method "GET" -URI http://www.contoso.com

此命令在名为 JobCollection01 的作业集合中创建计划程序 HTTP 作业。 该命令指定 URI，并将 GET 指定为方法。

示例 2：为特定运行计数创建 HTTP 作业

PS C:\> New-AzureSchedulerHttpJob -JobCollectionName "JobCollection01 -JobName "Job23" -Location "North Central US" -Method "GET" -URI http://www.contoso.com -ExecutionCount 20

此命令在名为 JobCollection01 的作业集合中创建计划程序 http 作业。 该命令指定 URI，并将 GET 指定为方法。 此命令使作业运行 20 次。

参数

-ClientCertificatePassword

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ClientCertificatePfx

类型:	Object
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EndTime

将计划程序停止启动作业的时间指定为 DateTime 对象。 若要获取 DateTime 对象，请使用 Get-Date cmdlet。 要了解详情，请键入 Get-Help Get-Date。

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ErrorActionHeaders

将标头指定为哈希表。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ErrorActionMethod

指定 HTTP 和 HTTPS 操作类型的方法。 有效值为：

• GET
• PUT
• POST
• HEAD
• DELETE

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ErrorActionQueueMessageBody

指定存储作业操作的正文。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ErrorActionRequestBody

指定 PUT 和 POST 作业操作的正文。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ErrorActionSASToken

指定存储队列的共享访问签名 （SAS） 令牌。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ErrorActionStorageAccount

指定存储帐户的名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ErrorActionStorageQueue

指定存储队列的名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ErrorActionURI

指定错误作业操作的 URI。

类型:	Uri
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ExecutionCount

指定运行作业的次数。 默认情况下，作业无限期递归。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Frequency

指定此计划程序作业的最大频率。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Headers

将标头指定为哈希表。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-HttpAuthenticationType

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Interval

使用 Frequency 参数指定频率的重复间隔。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-JobCollectionName

指定要包含计划程序作业的集合的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-JobName

指定计划程序作业的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-JobState

指定计划程序作业的状态。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Location

指定托管云服务的位置的名称。 有效值为：

• 亚洲任意地区
• 欧洲任意地区
• 美国任意地区
• 东亚
• 美国东部
• 美国中北部
• 北欧
• 美国中南部
• 东南亚
• 西欧
• 美国西部

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Method

指定 HTTP 和 HTTPS 操作类型的方法。 有效值为：

• GET
• PUT
• POST
• HEAD
• DELETE

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。

类型:	AzureSMProfile
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RequestBody

指定 PUT 和 POST 作业操作的正文。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StartTime

指定要启动作业的时间（作为 DateTime 对象）。

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-URI

指定作业操作的 URI。

类型:	Uri
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

相关链接

• Set-AzureSchedulerHttpJob