你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
New-AzureSchedulerStorageQueueJob
创建具有存储操作的计划程序作业。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。
Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。
语法
New-AzureSchedulerStorageQueueJob
-Location <String>
-JobCollectionName <String>
-JobName <String>
-StorageQueueAccount <String>
-StorageQueueName <String>
-SASToken <String>
[-StorageQueueMessage <String>]
[-StartTime <DateTime>]
[-Interval <Int32>]
[-Frequency <String>]
[-EndTime <DateTime>]
[-ExecutionCount <Int32>]
[-JobState <String>]
[-ErrorActionMethod <String>]
[-ErrorActionURI <Uri>]
[-ErrorActionRequestBody <String>]
[-ErrorActionHeaders <Hashtable>]
[-ErrorActionStorageAccount <String>]
[-ErrorActionStorageQueue <String>]
[-ErrorActionSASToken <String>]
[-ErrorActionQueueMessageBody <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] New-AzureSchedulerStorageQueueJob
[-StorageQueueMessage <String>]
[-Interval <Int32>]
[-Frequency <String>]
[-EndTime <DateTime>]
[-ExecutionCount <Int32>]
[-JobState <String>]
[-ErrorActionHeaders <Hashtable>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] 说明
本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。
若要获取正在使用的模块版本，请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version。
New-AzureSchedulerStorageQueueJob cmdlet 创建具有Azure 存储操作的计划程序作业。
示例
示例 1：创建运行一次的存储作业
PS C:\> New-AzureSchedulerStorageQueueJob -JobCollectionName "JobCollection01" -JobName "Job01" -Location "North Central US" -StorageQueueAccount "ContosoStorageAccount" -StorageQueueName "ContosoStorageQueue" -SASToken "?sv=2012-02-12&si=samplePolicy%2F30%2F2014%206%3A37%3A36%20PM&sig=vLQEbSfZbTFh7q3YrzlxBeL%2BjiYKp0gE6lMJ0a5Nb4M%3D"此命令将创建计划程序存储作业作为名为 JobCollection01 的集合的一部分。 该命令指定存储帐户、队列名称和 SAS 令牌。 作业立即运行一次。
示例 2：创建运行指定次数的存储作业
PS C:\> New-AzureSchedulerStorageQueueJob -JobCollectionName "JobCollection01" -JobName "Job12" -Location "North Central US"-StorageQueueAccount "ContosoStorageAccount" -StorageQueueName "ContosoStorageQueue" -SASToken "?sv=2012-02-12&si=samplePolicy%2F30%2F2014%206%3A37%3A36%20PM&sig=vLQEbSfZbTFh7q3YrzlxBeL%2BjiYKp0gE6lMJ0a5Nb4M%3D" -ExecutionCount 20 -Frequency "Hour" -Interval 2此命令将创建计划程序存储作业作为名为 JobCollection01 的集合的一部分。 该命令指定存储帐户、队列名称和 SAS 令牌。 作业总共运行 20 次，每小时运行两次。
参数
-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 |
-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 |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。
| 类型: | AzureSMProfile |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SASToken
指定存储队列的 SAS 令牌。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-StartTime
指定要启动作业的时间（作为 DateTime 对象）。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-StorageQueueAccount
指定存储帐户名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-StorageQueueMessage
指定存储作业的队列消息。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-StorageQueueName
指定存储队列的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |