Partilhar via

New-AzureSchedulerStorageQueueJob

  • Referência
Módulo:
Azure

Cria um trabalho de agendador que tem uma ação de armazenamento.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para gerenciar recursos do Azure Resource Manager.

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

Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure. Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

O cmdlet New-AzureSchedulerStorageQueueJob cria um trabalho de agendador que tem uma ação de Armazenamento do Azure.

Exemplos

Exemplo 1: Criar um trabalho de armazenamento que é executado uma vez

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"

Este comando cria um trabalho de armazenamento do agendador como parte da coleção chamada JobCollection01. O comando especifica a conta de armazenamento, o nome da fila e o token SAS. O trabalho é executado uma vez, imediatamente.

Exemplo 2: Criar um trabalho de armazenamento que seja executado um número especificado de vezes

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

Este comando cria um trabalho de armazenamento do agendador como parte da coleção chamada JobCollection01. O comando especifica a conta de armazenamento, o nome da fila e o token SAS. O trabalho é executado 20 vezes no total, duas vezes a cada hora.

Parâmetros

-EndTime

Especifica uma hora, como um objeto DateTime , para o agendador parar de iniciar o trabalho. Para obter um objeto DateTime , use o cmdlet Get-Date . Para obter mais informações, digite Get-Help Get-Date.

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

-ErrorActionHeaders

Especifica cabeçalhos como uma tabela de hash.

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

-ErrorActionMethod

Especifica o método para os tipos de ação HTTP e HTTPS. Os valores válidos são:

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

-ErrorActionQueueMessageBody

Especifica o corpo das ações do trabalho de armazenamento.

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

-ErrorActionRequestBody

Especifica o corpo para as ações de trabalho PUT e POST.

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

-ErrorActionSASToken

Especifica o token SAS (Assinatura de Acesso Compartilhado) para a fila de armazenamento.

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

-ErrorActionStorageAccount

Especifica o nome da conta de armazenamento.

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

-ErrorActionStorageQueue

Especifica o nome da fila de armazenamento.

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

-ErrorActionURI

Especifica o URI para a ação de trabalho de erro.

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

-ExecutionCount

Especifica o número de ocorrências de um trabalho que é executado. Por padrão, um trabalho é recorrente indefinidamente.

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

-Frequency

Especifica a frequência máxima para esse trabalho do agendador.

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

-Interval

Especifica o intervalo de recorrência na frequência especificada usando o parâmetro Frequency .

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

-JobCollectionName

Especifica o nome da coleção para conter o trabalho do agendador.

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

-JobName

Especifica o nome do trabalho do agendador.

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

-JobState

Especifica o estado do trabalho do agendador.

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

-Location

Especifica o nome do local que hospeda o serviço de nuvem. Os valores válidos são:

  • Em qualquer lugar da Ásia
  • Em qualquer parte da Europa
  • Em qualquer lugar dos EUA
  • Ásia Oriental
  • EUA Leste
  • E.U.A. Centro-Norte
  • Europa do Norte
  • E.U.A. Centro-Sul
  • Sudeste Asiático
  • Europa Ocidental
  • EUA Oeste
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

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

-SASToken

Especifica o token SAS para a fila de armazenamento.

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

-StartTime

Especifica uma hora, como um objeto DateTime , para o trabalho iniciar.

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

-StorageQueueAccount

Especifica o nome da conta de armazenamento.

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

-StorageQueueMessage

Especifica a mensagem de fila para o trabalho de armazenamento.

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

-StorageQueueName

Especifica o nome da fila de armazenamento.

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