New-AzureSchedulerStorageQueueJob
Cria um trabalho do agendador que tem uma ação de armazenamento.
Observação
Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de 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 do 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 do agendador que tem uma ação de Armazenamento do Azure.
Exemplos
Exemplo 1: Criar um trabalho de armazenamento 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 executa 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
.
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 (excluir)
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ErrorActionQueueMessageBody
Especifica o corpo das ações de trabalho de armazenamento.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ErrorActionRequestBody
Especifica o corpo das 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 se repete 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 lugar da Europa
- Em qualquer lugar 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
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 lê. 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 ser iniciado.
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 |