你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-AzBatchJob

获取 Batch 帐户或作业计划的 Batch 作业。

语法

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>]

说明

Get-AzBatchJob cmdlet 获取 BatchAccountContext 参数指定的 Batch 帐户的 Azure Batch 作业。 可以使用 Id 参数获取单个作业。 可以使用 Filter 参数获取与开放数据协议 (OData) 筛选器匹配的作业。 如果提供作业计划 ID 或 PSCloudJobSchedule 实例,此 cmdlet 仅返回该作业计划的作业。

示例

示例 1:按 ID 获取 Batch 作业

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

此命令获取 ID 为 Job01 的作业。 使用 Get-AzBatchAccountKey cmdlet 将上下文分配给$Context变量。

示例 2:获取作业计划的所有活动作业

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

此命令获取 ID 为 JobSchedule27 的作业计划的活动作业。

示例 3:使用管道获取作业计划下的所有作业

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

此命令使用 Get-AzBatchJobSchedule cmdlet 获取 ID JobSchedule27 的作业计划。 该命令使用管道运算符将该作业计划传递给当前 cmdlet。 该命令获取该作业计划的所有作业。

参数

-BatchContext

指定 此 cmdlet 用于与 Batch 服务交互的 BatchAccountContext 实例。 如果使用 Get-AzBatchAccount cmdlet 获取 BatchAccountContext,Microsoft 则在与 Batch 服务交互时将使用 entra 身份验证。 若要改用共享密钥身份验证,请使用 Get-AzBatchAccountKey cmdlet 获取填充其访问密钥的 BatchAccountContext 对象。 使用共享密钥身份验证时,默认使用主访问密钥。 若要更改要使用的密钥,请设置 BatchAccountContext.KeyInUse 属性。

类型:BatchAccountContext
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Expand

指定 Open Data Protocol (OData) expand 子句。 指定此参数的值以获取你获取的主实体的关联实体。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Filter

指定作业的 OData 筛选器子句。 如果未指定筛选器,此 cmdlet 将返回 Batch 帐户或作业计划的所有作业。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Id

指定此 cmdlet 获取的作业的 ID。 不能指定通配符。

类型:String
Position:0
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-JobSchedule

指定一个 PSCloudJobSchedule 对象,该对象表示包含作业的作业计划。 若要获取 PSCloudJobSchedule 对象,请使用 Get-AzBatchJobSchedule cmdlet。

类型:PSCloudJobSchedule
Position:0
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-JobScheduleId

指定包含作业的作业计划的 ID。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-MaxCount

指定要返回的最大作业数。 如果指定值为零(0)或更少,则 cmdlet 不使用上限。 默认值为 1000。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Select

指定 OData select 子句。 指定此参数的值以获取特定属性,而不是所有对象属性。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

String

PSCloudJobSchedule

BatchAccountContext

输出

PSCloudJob