New-AzBatchJob
Crea un trabajo en el servicio Batch.
Sintaxis
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 $ContextEl 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 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | 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 |
| Alias: | CommonEnvironmentSetting |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Constraints
Especifica las restricciones de ejecución para el trabajo.
| Tipo: | PSJobConstraints |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
| Tipo: | IAzureContextContainer |
| Alias: | AzContext, AzureRmContext, AzureCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DisplayName
Especifica el nombre para mostrar del trabajo.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Id
Especifica un identificador para el trabajo.
| Tipo: | String |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-JobManagerTask
Especifica la tarea Administrador de trabajos. El servicio Batch ejecuta la tarea Administrador de trabajos cuando se inicia el trabajo.
| Tipo: | PSJobManagerTask |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PoolInformation
Especifica los detalles del grupo en el que el servicio Batch ejecuta las tareas del trabajo.
| Tipo: | PSPoolInformation |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-UsesTaskDependencies
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |