New-AzureSchedulerHttpJob

模組:

Azure

建立具有 HTTP 動作的排程器作業。

注意

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

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

Description

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