Share via

Get-AzBatchJob

  • Referência
Módulo:
Az.Batch

Obtém trabalhos em lote para uma conta ou agenda de trabalho em lote.

Syntax

Get-AzBatchJob
   [-JobScheduleId <String>]
   [-Filter <String>]
   [-MaxCount <Int32>]
   [-Select <String>]
   [-Expand <String>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchJob
   [[-Id] <String>]
   [-Select <String>]
   [-Expand <String>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchJob
   [[-JobSchedule] <PSCloudJobSchedule>]
   [-Filter <String>]
   [-MaxCount <Int32>]
   [-Select <String>]
   [-Expand <String>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Get-AzBatchJob obtém os trabalhos do Lote do Azure para a conta Batch especificada pelo parâmetro BatchAccountContext . Você pode usar o parâmetro Id para obter um único trabalho. Você pode usar o parâmetro Filter para obter os trabalhos que correspondem a um filtro OData (Open Data Protocol). Se você fornecer uma ID de agenda de trabalho ou uma instância PSCloudJobSchedule , esse cmdlet retornará apenas os trabalhos para essa agenda de trabalho.

Exemplos

Exemplo 1: Obter um trabalho em lote por ID

Get-AzBatchJob -Id "Job01" -BatchContext $Context

CommonEnvironmentSettings   :
Constraints                 : Microsoft.Azure.Commands.Batch.Models.PSJobConstraints
CreationTime                : 7/25/2015 9:12:07 PM
DisplayName                 :
ETag                        : 0x8D29535B2941439
ExecutionInformation        : Microsoft.Azure.Commands.Batch.Models.PSJobExecutionInformation
Id                          : Job01
JobManagerTask              :
JobPreparationTask          :
JobReleaseTask              :
LastModified                : 7/25/2015 9:12:07 PM
Metadata                    :
PoolInformation             : Microsoft.Azure.Commands.Batch.Models.PSPoolInformation
PreviousState               :
PreviousStateTransitionTime :
Priority                    : 0
State                       : Active
StateTransitionTime         : 7/25/2015 9:12:07 PM
Statistics                  :
Url                         : https://pfuller.westus.batch.azure.com/jobs/Job01

Este comando obtém o trabalho que tem a ID Job01. Use o cmdlet Get-AzBatchAccountKey para atribuir um contexto à variável $Context.

Exemplo 2: Obter todos os trabalhos ativos para uma agenda de trabalhos

Get-AzBatchJob -JobScheduleId "JobSchedule27" -Filter "state eq 'active'" -BatchContext $Context

CommonEnvironmentSettings   :
Constraints                 : Microsoft.Azure.Commands.Batch.Models.PSJobConstraints
CreationTime                : 7/25/2015 9:15:44 PM
DisplayName                 :
ETag                        : 0x8D2953633DD13E1
ExecutionInformation        : Microsoft.Azure.Commands.Batch.Models.PSJobExecutionInformation
Id                          : JobSchedule27:job-1
JobManagerTask              :
JobPreparationTask          :
JobReleaseTask              :
LastModified                : 7/25/2015 9:15:44 PM
Metadata                    :
PoolInformation             : Microsoft.Azure.Commands.Batch.Models.PSPoolInformation
PreviousState               :
PreviousStateTransitionTime :
Priority                    : 0
State                       : Active
StateTransitionTime         : 7/25/2015 9:15:44 PM
Statistics                  :
Url                         : https://pfuller.westus.batch.azure.com/jobs/JobSchedule27:job-1

Este comando obtém os trabalhos ativos para a agenda de trabalho que tem a ID JobSchedule27.

Exemplo 3: Obtém todos os trabalhos sob um cronograma de trabalho usando o pipeline

Get-AzBatchJobSchedule -Id "JobSchedule27" -BatchContext $Context | Get-AzBatchJob -BatchContext $Context

CommonEnvironmentSettings   :
Constraints                 : Microsoft.Azure.Commands.Batch.Models.PSJobConstraints
CreationTime                : 7/25/2015 9:15:44 PM
DisplayName                 :
ETag                        : 0x8D2953633DD13E1
ExecutionInformation        : Microsoft.Azure.Commands.Batch.Models.PSJobExecutionInformation
Id                          : JobSchedule27:job-1
JobManagerTask              :
JobPreparationTask          :
JobReleaseTask              :
LastModified                : 7/25/2015 9:15:44 PM
Metadata                    :
PoolInformation             : Microsoft.Azure.Commands.Batch.Models.PSPoolInformation
PreviousState               :
PreviousStateTransitionTime :
Priority                    : 0
State                       : Active
StateTransitionTime         : 7/25/2015 9:15:44 PM
Statistics                  :
Url                         : https://pfuller.westus.batch.azure.com/jobs/JobSchedule27:job-1

Este comando obtém a agenda de trabalho que tem a ID JobSchedule27 usando o cmdlet Get-AzBatchJobSchedule. O comando passa essa agenda de trabalho para o cmdlet atual usando o operador de pipeline. O comando obtém todos os trabalhos para essa agenda de trabalho.

Parâmetros

-BatchContext

Especifica a instância BatchAccountContext que esse cmdlet usa para interagir com o serviço Batch. Se você usar o cmdlet Get-AzBatchAccount para obter seu BatchAccountContext, a autenticação do Microsoft Entra será usada ao interagir com o serviço Batch. Para usar a autenticação de chave compartilhada, use o cmdlet Get-AzBatchAccountKey para obter um objeto BatchAccountContext com suas chaves de acesso preenchidas. Ao usar a autenticação de chave compartilhada, a chave de acesso primária é usada por padrão. Para alterar a chave a ser usada, defina a propriedade BatchAccountContext.KeyInUse.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Expand

Especifica uma cláusula de expansão OData (Open Data Protocol). Especifique um valor para esse parâmetro para obter entidades associadas da entidade principal que você obtém.

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

-Filter

Especifica uma cláusula de filtro OData para trabalhos. Se você não especificar um filtro, esse cmdlet retornará todos os trabalhos para a conta de lote ou agenda de trabalho.

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

-Id

Especifica a ID do trabalho que esse cmdlet obtém. Não é possível especificar caracteres curinga.

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

-JobSchedule

Especifica um objeto PSCloudJobSchedule que representa a agenda de trabalho que contém os trabalhos. Para obter um objeto PSCloudJobSchedule , use o cmdlet Get-AzBatchJobSchedule.

Type:PSCloudJobSchedule
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-JobScheduleId

Especifica a ID da agenda de trabalho que contém os trabalhos.

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

-MaxCount

Especifica o número máximo de trabalhos a serem retornados. Se você especificar um valor de zero (0) ou menos, o cmdlet não usará um limite superior. O valor predefinido é 1000.

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

-Select

Especifica uma cláusula de seleção OData. Especifique um valor para esse parâmetro para obter propriedades específicas em vez de todas as propriedades do objeto.

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

Entradas

String

PSCloudJobSchedule

BatchAccountContext

Saídas

PSCloudJob