Compartir a través de

New-AzBatchJob

  • Referencia
Módulo:
Az.Batch

Crea un trabajo en el servicio Batch.

Syntax

New-AzBatchJob
   [-Id] <String>
   [-CommonEnvironmentSettings <IDictionary>]
   [-DisplayName <String>]
   [-Constraints <PSJobConstraints>]
   [-JobManagerTask <PSJobManagerTask>]
   [-JobPreparationTask <PSJobPreparationTask>]
   [-JobReleaseTask <PSJobReleaseTask>]
   [-Metadata <IDictionary>]
   -PoolInformation <PSPoolInformation>
   [-Priority <Int32>]
   [-UsesTaskDependencies]
   [-OnTaskFailure <OnTaskFailure>]
   [-OnAllTasksComplete <OnAllTasksComplete>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet New-AzBatchJob crea un trabajo en el servicio Azure Batch en la cuenta especificada por el parámetro BatchAccountContext .

Ejemplos

Ejemplo 1: Creación de un trabajo

$PoolInformation = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSPoolInformation"
$PoolInformation.PoolId = "Pool22"
New-AzBatchJob -Id "ContosoJob35" -PoolInformation $PoolInformation -BatchContext $Context

El primer comando crea un objeto PSPoolInformation mediante el cmdlet New-Object. El comando almacena ese objeto en la variable $PoolInformation. El segundo comando asigna el id. Pool22 a la propiedad PoolId del objeto en $PoolInformation. El comando final crea un trabajo que tiene el identificador ContosoJob35. Las tareas agregadas al trabajo se ejecutan en el grupo que tiene el id. Pool22. Use el cmdlet Get-AzBatchAccountKey para asignar un contexto a la variable $Context.

Parámetros

-BatchContext

Especifica la instancia de BatchAccountContext que usa este cmdlet para interactuar con el servicio Batch. Si usa el cmdlet Get-AzBatchAccount para obtener batchAccountContext, se usará la autenticación de Microsoft Entra al interactuar con el servicio Batch. Para usar la autenticación de clave compartida en su lugar, use el cmdlet Get-AzBatchAccountKey para obtener un objeto BatchAccountContext con sus claves de acceso rellenadas. Al usar la autenticación de clave compartida, la clave de acceso principal se usa de forma predeterminada. Para cambiar la clave que se va a usar, establezca la propiedad BatchAccountContext.KeyInUse.

Tipo:BatchAccountContext
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-CommonEnvironmentSettings

Especifica las variables de entorno comunes, como pares clave-valor, que este cmdlet establece para todas las tareas del trabajo. La clave es el nombre de la variable de entorno. El valor es el valor de la variable de entorno.

Tipo:IDictionary
Aliases:CommonEnvironmentSetting
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Constraints

Especifica las restricciones de ejecución para el trabajo.

Tipo:PSJobConstraints
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Especifica el nombre para mostrar del trabajo.

Tipo:String
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifica un identificador para el trabajo.

Tipo:String
Position:0
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-JobManagerTask

Especifica la tarea Administrador de trabajos. El servicio Batch ejecuta la tarea Administrador de trabajos cuando se inicia el trabajo.

Tipo:PSJobManagerTask
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-JobPreparationTask

Especifica la tarea Preparación del trabajo. El servicio Batch ejecuta la tarea Preparación del trabajo en un nodo de proceso antes de iniciar cualquier tarea de ese trabajo en ese nodo de proceso.

Tipo:PSJobPreparationTask
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-JobReleaseTask

Especifica la tarea Liberación del trabajo. El servicio Batch ejecuta la tarea Job Release cuando finaliza el trabajo. El servicio Batch ejecuta la tarea Job Release en cada nodo de proceso donde ejecutó cualquier tarea del trabajo.

Tipo:PSJobReleaseTask
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Metadata

Especifica los metadatos, como pares clave-valor, que se van a agregar al trabajo. La clave es el nombre de los metadatos. El valor es el valor de metadatos.

Tipo:IDictionary
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-OnAllTasksComplete

Especifica una acción que realiza el servicio Batch si todas las tareas del trabajo están en estado completado.

Tipo:Nullable<T>[OnAllTasksComplete]
valores aceptados:NoAction, TerminateJob
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-OnTaskFailure

Especifica una acción que realiza el servicio Batch si se produce un error en alguna tarea del trabajo.

Tipo:Nullable<T>[OnTaskFailure]
valores aceptados:NoAction, PerformExitOptionsJobAction
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-PoolInformation

Especifica los detalles del grupo en el que el servicio Batch ejecuta las tareas del trabajo.

Tipo:PSPoolInformation
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:False
Accept wildcard characters:False

-Priority

Especifica la prioridad del trabajo. Los valores válidos son: enteros de -1000 a 1000. Un valor de -1000 es la prioridad más baja. Un valor de 1000 es la prioridad más alta. El valor predeterminado es 0.

Tipo:Int32
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-UsesTaskDependencies

Tipo:SwitchParameter
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

BatchAccountContext

Salidas

Void