Compartilhar via

New-AzureSchedulerStorageQueueJob

  • Referência
Módulo:
Azure

Cria um trabalho do agendador que tem uma ação Armazenamento.

Observação

Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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 do Microsoft Azure PowerShell. 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 do 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"

Esse 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 é 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

Esse 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.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ErrorActionHeaders

Especifica cabeçalhos como uma tabela de hash.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ErrorActionMethod

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

  • GET
  • PUT
  • POSTAR
  • HEAD
  • DELETE
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ErrorActionQueueMessageBody

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ErrorActionRequestBody

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ErrorActionSASToken

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ErrorActionStorageAccount

Especifica o nome da conta de armazenamento.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ErrorActionStorageQueue

Especifica o nome da fila de armazenamento.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ErrorActionURI

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

Tipo:Uri
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExecutionCount

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Frequency

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Interval

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobCollectionName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-JobName

Especifica o nome do trabalho do agendador.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-JobState

Especifica o estado do trabalho do agendador.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Location

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

  • Em qualquer lugar Ásia
  • Em qualquer lugar da Europa
  • Em qualquer lugar dos EUA
  • Leste da Ásia
  • Leste dos EUA
  • Centro-Norte dos EUA
  • Norte da Europa
  • Centro-Sul dos Estados Unidos
  • Sudeste Asiático
  • Europa Ocidental
  • Oeste dos EUA
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Profile

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

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SASToken

Especifica o token SAS para a fila de armazenamento.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-StartTime

Especifica uma hora, como um objeto DateTime , para o início do trabalho.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StorageQueueAccount

Especifica o nome da conta de armazenamento.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-StorageQueueMessage

Especifica a mensagem da fila para o trabalho de armazenamento.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StorageQueueName

Especifica o nome da fila de armazenamento.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False