共用方式為

New-AzureSchedulerStorageQueueJob

  • 參考
模組:
Azure

建立具有記憶體動作的排程器作業。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （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>]

Description

本主題描述 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