New-AzureSchedulerStorageQueueJob
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 do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo PowerShell recomendado 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 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 2Este 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 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ErrorActionHeaders
Especifica cabeçalhos como uma tabela de hash.
| Tipo: | Hashtable |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | 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
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ErrorActionQueueMessageBody
Especifica o corpo das ações do trabalho de armazenamento.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ErrorActionRequestBody
Especifica o corpo para as ações de trabalho PUT e POST.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ErrorActionSASToken
Especifica o token SAS (Assinatura de Acesso Compartilhado) para a fila de armazenamento.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-ErrorActionStorageAccount
Especifica o nome da conta de armazenamento.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-ErrorActionStorageQueue
Especifica o nome da fila de armazenamento.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-ErrorActionURI
Especifica o URI para a ação de trabalho de erro.
| Tipo: | Uri |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ExecutionCount
Especifica o número de ocorrências de um trabalho que é executado. Por padrão, um trabalho é recorrente indefinidamente.
| Tipo: | Int32 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Frequency
Especifica a frequência máxima para esse trabalho do agendador.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Interval
Especifica o intervalo de recorrência na frequência especificada usando o parâmetro Frequency .
| Tipo: | Int32 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-JobCollectionName
Especifica o nome da coleção para conter o trabalho do agendador.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-JobName
Especifica o nome do trabalho do agendador.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-JobState
Especifica o estado do trabalho do agendador.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | 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 Leste
- E.U.A. Leste
- E.U.A. Centro-Norte
- Europa do Norte
- E.U.A. Centro-Sul
- Sudeste Asiático
- Europa Ocidental
- E.U.A. Oeste
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | 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.
| Tipo: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-SASToken
Especifica o token SAS para a fila de armazenamento.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-StartTime
Especifica uma hora, como um objeto DateTime , para o trabalho iniciar.
| Tipo: | DateTime |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-StorageQueueAccount
Especifica o nome da conta de armazenamento.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-StorageQueueMessage
Especifica a mensagem de fila para o trabalho de armazenamento.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-StorageQueueName
Especifica o nome da fila de armazenamento.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |