New-AzureSchedulerStorageQueueJob
Erstellt einen Zeitplanauftrag mit einer Speicheraktion.
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-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 2Mit 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.
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ErrorActionHeaders
Gibt Überschriften 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 |
-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 |
-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 |
-SASToken
Gibt das SAS-Token für die Speicherwarteschlange an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| 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 |
-StorageQueueAccount
Gibt den Namen des Speicherkontos an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StorageQueueMessage
Gibt die Warteschlangenmeldung für den Speicherauftrag an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-StorageQueueName
Gibt den Namen der Speicherwarteschlange an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |