Delen via

New-AzureSchedulerStorageQueueJob

  • Referentie
Module:
Azure

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.

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

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 2

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 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
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorActionHeaders

Hiermee geeft u headers als een hash-tabel.

Type:Hashtable
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ErrorActionMethod

Hiermee geeft u de methode voor HTTP- en HTTPS-actietypen. Geldige waarden zijn:

  • GET
  • PUT
  • POSTEN
  • HEAD
  • DELETE
Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorActionQueueMessageBody

Hiermee geeft u de hoofdtekst voor opslagtaakacties.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorActionRequestBody

Hiermee geeft u de hoofdtekst voor PUT- en POST-taakacties op.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorActionSASToken

Hiermee geeft u het SAS-token (Shared Access Signature) voor de opslagwachtrij op.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ErrorActionStorageAccount

Hiermee geeft u de naam van het opslagaccount.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ErrorActionStorageQueue

Hiermee geeft u de naam van de opslagwachtrij.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ErrorActionURI

Hiermee geeft u de URI voor de fouttaakactie.

Type:Uri
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Frequency

Hiermee geeft u de maximale frequentie voor deze scheduler-taak.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-JobCollectionName

Hiermee geeft u de naam van de verzameling die de scheduler-taak bevat.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-JobName

Hiermee geeft u de naam voor de scheduler-taak.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-JobState

Hiermee geeft u de status voor de scheduler-taak.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters: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
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-SASToken

Hiermee geeft u het SAS-token voor de opslagwachtrij.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-StartTime

Hiermee geeft u een tijd, als een DateTime-object , op om de taak te starten.

Type:DateTime
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageQueueAccount

Hiermee geeft u de naam van het opslagaccount op.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageQueueMessage

Hiermee geeft u het wachtrijbericht voor de opslagtaak.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageQueueName

Hiermee geeft u de naam van de opslagwachtrij.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False