New-AzureSchedulerStorageQueueJob

  • Referenz
Modul:
Azure

Erstellt einen Zeitplanauftrag mit einer Speicheraktion.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

Syntax

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

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-AzureSchedulerStorageQueueJob erstellt einen Zeitplanauftrag mit einer Azure Storage-Aktion.

Beispiele

Beispiel 1: Erstellen eines Speicherauftrags, der einmal ausgeführt wird

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"

Mit diesem Befehl wird ein Zeitplanspeicherauftrag als Teil der Sammlung namens JobCollection01 erstellt. Der Befehl gibt das Speicherkonto, den Warteschlangennamen und das SAS-Token an. Der Auftrag wird einmal ausgeführt, sofort.

Beispiel 2: Erstellen eines Speicherauftrags, der eine bestimmte Anzahl von Malen ausführt

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

Mit diesem Befehl wird ein Zeitplanspeicherauftrag als Teil der Sammlung namens JobCollection01 erstellt. Der Befehl gibt das Speicherkonto, den Warteschlangennamen und das SAS-Token an. Der Auftrag wird insgesamt 20 Mal pro Stunde ausgeführt.

Parameter

-EndTime

Gibt eine Uhrzeit als DateTime-Objekt an, damit der Scheduler das Initiieren des Auftrags beenden kann. Verwenden Sie zum Abrufen eines DateTime-Objekts das Cmdlet "Get-Date ". Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Date.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorActionHeaders

Gibt Überschriften als Hashtabelle an.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ErrorActionMethod

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

  • GET
  • PUT
  • POST
  • HEAD
  • DELETE
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorActionQueueMessageBody

Gibt den Text für Speicherauftragsaktionen an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorActionRequestBody

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorActionSASToken

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ErrorActionStorageAccount

Gibt den Namen des Speicherkontos an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ErrorActionStorageQueue

Gibt den Namen der Speicherwarteschlange an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ErrorActionURI

Gibt den URI für die Fehlerauftragsaktion an.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExecutionCount

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Frequency

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Interval

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobCollectionName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-JobName

Gibt den Namen für den Zeitplanauftrag an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-JobState

Gibt den Status für den Zeitplanauftrag an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
  • East US
  • USA Nord Mitte
  • Nordeuropa
  • USA Süd Mitte
  • Asien, Südosten
  • Europa, Westen
  • USA (Westen)
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SASToken

Gibt das SAS-Token für die Speicherwarteschlange an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StartTime

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

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageQueueAccount

Gibt den Namen des Speicherkontos an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageQueueMessage

Gibt die Warteschlangenmeldung für den Speicherauftrag an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageQueueName

Gibt den Namen der Speicherwarteschlange an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False