Freigeben über

New-AzureSchedulerHttpJob

  • Referenz
Modul:
Azure

Erstellt einen Zeitplanauftrag mit einer HTTP-Aktion.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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>]

Beschreibung

In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Das Cmdlet New-AzureSchedulerHttpJob erstellt einen Zeitplanauftrag mit einer HTTP-Aktion.

Beispiele

Beispiel 1: Erstellen eines HTTP-Auftrags

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

Dieser Befehl erstellt einen Zeitplan-HTTP-Auftrag in der Auftragssammlung namens JobCollection01. Der Befehl gibt einen URI an und gibt GET als Methode an.

Beispiel 2: Erstellen eines HTTP-Auftrags für eine bestimmte Ausführungsanzahl

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

Mit diesem Befehl wird der Zeitplan-HTTP-Auftrag in der Auftragssammlung namens JobCollection01 erstellt. Der Befehl gibt einen URI an und gibt GET als Methode an. Dieser Befehl bewirkt, dass der Auftrag 20 Mal ausgeführt wird.

Parameter

-ClientCertificatePassword

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ClientCertificatePfx

Typ:Object
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EndTime

Gibt eine Uhrzeit als DateTime-Objekt an, damit der Scheduler das Initiieren von Aufträgen beendet. Verwenden Sie zum Abrufen eines DateTime-Objekts das Cmdlet "Get-Date ". Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Date.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ErrorActionHeaders

Gibt Kopfzeilen als Hashtabelle an.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ErrorActionMethod

Gibt die Methode für HTTP- und HTTPS-Aktionstypen an. Gültige Werte sind:

  • GET
  • PUT
  • POST
  • HEAD
  • DELETE
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ErrorActionQueueMessageBody

Gibt den Text für Speicherauftragsaktionen an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ErrorActionRequestBody

Gibt den Text für PUT- und POST-Auftragsaktionen an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ErrorActionSASToken

Gibt das SAS-Token (Shared Access Signature) für die Speicherwarteschlange an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ErrorActionStorageAccount

Gibt den Namen des Speicherkontos an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ErrorActionStorageQueue

Gibt den Namen der Speicherwarteschlange an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ErrorActionURI

Gibt den URI für die Fehlerauftragsaktion an.

Typ:Uri
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExecutionCount

Gibt die Anzahl der Vorkommen eines Auftrags an, der ausgeführt wird. Standardmäßig wird ein Auftrag unbegrenzt rekursiert.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Frequency

Gibt die maximale Häufigkeit für diesen Zeitplanauftrag an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Headers

Gibt die Kopfzeilen als Hashtabelle an.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-HttpAuthenticationType

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Interval

Gibt das Intervall der Wiederholung an der häufigkeit an, die mithilfe des Parameters Frequency angegeben wird.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobCollectionName

Gibt den Namen der Auflistung an, die den Zeitplanauftrag enthalten soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-JobName

Gibt den Namen für den Zeitplanauftrag an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-JobState

Gibt den Status für den Zeitplanauftrag an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Location

Gibt den Namen des Speicherorts an, an dem der Clouddienst gehostet wird. Gültige Werte sind:

  • Überall in Asien
  • Überall in Europa
  • Überall IN DEN USA
  • Asien, Osten
  • USA, Osten
  • USA Nord Mitte
  • Nordeuropa
  • USA Süd Mitte
  • Asien, Südosten
  • Europa, Westen
  • USA (Westen)
Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Method

Gibt die Methode für HTTP- und HTTPS-Aktionstypen an. Gültige Werte sind:

  • GET
  • PUT
  • POST
  • HEAD
  • DELETE
Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RequestBody

Gibt den Text für PUT- und POST-Auftragsaktionen an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StartTime

Gibt eine Uhrzeit als DateTime-Objekt an, damit der Auftrag gestartet werden soll.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-URI

Gibt einen URI für eine Auftragsaktion an.

Typ:Uri
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False