New-AzureSchedulerStorageQueueJob
Hiermee maakt u een scheduler-taak met een opslagactie.
Notitie
De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.
De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.
Syntaxis
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
In dit onderwerp wordt de cmdlet in de versie 0.8.10 van de Microsoft Azure PowerShell-module beschreven.
Als u de versie van de module wilt ophalen die u gebruikt, typt (Get-Module -Name Azure).Versionu in de Azure PowerShell-console.
De cmdlet New-AzureSchedulerStorageQueueJob maakt een scheduler-taak met een Azure Storage-actie.
Voorbeelden
Voorbeeld 1: Een opslagtaak maken die eenmaal wordt uitgevoerd
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"Met deze opdracht maakt u een scheduler Storage-taak als onderdeel van de verzameling JobCollection01. Met de opdracht geeft u het opslagaccount, de wachtrijnaam en het SAS-token op. De taak wordt eenmaal uitgevoerd, onmiddellijk.
Voorbeeld 2: Een opslagtaak maken die een opgegeven aantal keren wordt uitgevoerd
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 2Met deze opdracht maakt u een scheduler Storage-taak als onderdeel van de verzameling JobCollection01. Met de opdracht geeft u het opslagaccount, de wachtrijnaam en het SAS-token op. De taak wordt in totaal 20 keer uitgevoerd, twee keer per uur.
Parameters
-EndTime
Hiermee geeft u een tijd op, als een DateTime-object , zodat de planner stopt met het initiëren van de taak.
Gebruik de cmdlet Get-Date om een DateTime-object op te halen.
Typ voor meer informatie Get-Help Get-Date.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ErrorActionHeaders
Hiermee geeft u headers als een hash-tabel.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ErrorActionMethod
Hiermee geeft u de methode voor HTTP- en HTTPS-actietypen. Geldige waarden zijn:
- GET
- PUT
- POSTEN
- HEAD
- DELETE
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ErrorActionQueueMessageBody
Hiermee geeft u de hoofdtekst voor opslagtaakacties.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ErrorActionRequestBody
Hiermee geeft u de hoofdtekst voor PUT- en POST-taakacties op.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ErrorActionSASToken
Hiermee geeft u het SAS-token (Shared Access Signature) voor de opslagwachtrij op.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ErrorActionStorageAccount
Hiermee geeft u de naam van het opslagaccount.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ErrorActionStorageQueue
Hiermee geeft u de naam van de opslagwachtrij.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ErrorActionURI
Hiermee geeft u de URI voor de fouttaakactie.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ExecutionCount
Hiermee geeft u het aantal exemplaren op van een taak die wordt uitgevoerd. Standaard wordt een taak voor onbepaalde tijd herhaald.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Frequency
Hiermee geeft u de maximale frequentie voor deze scheduler-taak.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Interval
Hiermee geeft u het interval van terugkeerpatroon op voor de frequentie die is opgegeven met behulp van de parameter Frequentie .
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-JobCollectionName
Hiermee geeft u de naam van de verzameling die de scheduler-taak bevat.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-JobName
Hiermee geeft u de naam voor de scheduler-taak.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-JobState
Hiermee geeft u de status voor de scheduler-taak.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Location
Hiermee geeft u de naam op van de locatie die als host fungeert voor de cloudservice. Geldige waarden zijn:
- Overal Azië
- Overal in Europa
- Waar dan ook, VS
- Azië - oost
- VS - oost
- VS - noord-centraal
- Europa - noord
- VS - zuid-centraal
- Azië - zuidoost
- Europa -west
- VS - west
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Profile
Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-SASToken
Hiermee geeft u het SAS-token voor de opslagwachtrij.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-StartTime
Hiermee geeft u een tijd, als een DateTime-object , op om de taak te starten.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-StorageQueueAccount
Hiermee geeft u de naam van het opslagaccount op.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-StorageQueueMessage
Hiermee geeft u het wachtrijbericht voor de opslagtaak.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-StorageQueueName
Hiermee geeft u de naam van de opslagwachtrij.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |