New-AzBatchPool
Crea un grupo en el servicio Batch.
Syntax
New-AzBatchPool
[-Id] <String>
-VirtualMachineSize <String>
[-DisplayName <String>]
[-ResizeTimeout <TimeSpan>]
[-TargetDedicatedComputeNodes <Int32>]
[-TargetLowPriorityComputeNodes <Int32>]
[-TaskSlotsPerNode <Int32>]
[-UpgradePolicy <PSUpgradePolicy>]
[-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
[-ResourceTag <IDictionary>]
[-Metadata <IDictionary>]
[-InterComputeNodeCommunicationEnabled]
[-StartTask <PSStartTask>]
[-CertificateReferences <PSCertificateReference[]>]
[-ApplicationPackageReferences <PSApplicationPackageReference[]>]
[-ApplicationLicenses <System.Collections.Generic.List`1[System.String]>]
[-CloudServiceConfiguration <PSCloudServiceConfiguration>]
[-NetworkConfiguration <PSNetworkConfiguration>]
[-MountConfiguration <PSMountConfiguration[]>]
[-UserAccount <PSUserAccount[]>]
[-CurrentNodeCommunicationMode <NodeCommunicationMode>]
[-TargetNodeCommunicationMode <NodeCommunicationMode>]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzBatchPool
[-Id] <String>
-VirtualMachineSize <String>
[-DisplayName <String>]
[-ResizeTimeout <TimeSpan>]
[-TargetDedicatedComputeNodes <Int32>]
[-TargetLowPriorityComputeNodes <Int32>]
[-TaskSlotsPerNode <Int32>]
[-UpgradePolicy <PSUpgradePolicy>]
[-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
[-ResourceTag <IDictionary>]
[-Metadata <IDictionary>]
[-InterComputeNodeCommunicationEnabled]
[-StartTask <PSStartTask>]
[-CertificateReferences <PSCertificateReference[]>]
[-ApplicationPackageReferences <PSApplicationPackageReference[]>]
[-ApplicationLicenses <System.Collections.Generic.List`1[System.String]>]
[-VirtualMachineConfiguration <PSVirtualMachineConfiguration>]
[-NetworkConfiguration <PSNetworkConfiguration>]
[-MountConfiguration <PSMountConfiguration[]>]
[-UserAccount <PSUserAccount[]>]
[-CurrentNodeCommunicationMode <NodeCommunicationMode>]
[-TargetNodeCommunicationMode <NodeCommunicationMode>]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzBatchPool
[-Id] <String>
-VirtualMachineSize <String>
[-DisplayName <String>]
[-AutoScaleEvaluationInterval <TimeSpan>]
[-AutoScaleFormula <String>]
[-TaskSlotsPerNode <Int32>]
[-UpgradePolicy <PSUpgradePolicy>]
[-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
[-ResourceTag <IDictionary>]
[-Metadata <IDictionary>]
[-InterComputeNodeCommunicationEnabled]
[-StartTask <PSStartTask>]
[-CertificateReferences <PSCertificateReference[]>]
[-ApplicationPackageReferences <PSApplicationPackageReference[]>]
[-ApplicationLicenses <System.Collections.Generic.List`1[System.String]>]
[-CloudServiceConfiguration <PSCloudServiceConfiguration>]
[-NetworkConfiguration <PSNetworkConfiguration>]
[-MountConfiguration <PSMountConfiguration[]>]
[-UserAccount <PSUserAccount[]>]
[-CurrentNodeCommunicationMode <NodeCommunicationMode>]
[-TargetNodeCommunicationMode <NodeCommunicationMode>]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzBatchPool
[-Id] <String>
-VirtualMachineSize <String>
[-DisplayName <String>]
[-AutoScaleEvaluationInterval <TimeSpan>]
[-AutoScaleFormula <String>]
[-TaskSlotsPerNode <Int32>]
[-UpgradePolicy <PSUpgradePolicy>]
[-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
[-ResourceTag <IDictionary>]
[-Metadata <IDictionary>]
[-InterComputeNodeCommunicationEnabled]
[-StartTask <PSStartTask>]
[-CertificateReferences <PSCertificateReference[]>]
[-ApplicationPackageReferences <PSApplicationPackageReference[]>]
[-ApplicationLicenses <System.Collections.Generic.List`1[System.String]>]
[-VirtualMachineConfiguration <PSVirtualMachineConfiguration>]
[-NetworkConfiguration <PSNetworkConfiguration>]
[-MountConfiguration <PSMountConfiguration[]>]
[-UserAccount <PSUserAccount[]>]
[-CurrentNodeCommunicationMode <NodeCommunicationMode>]
[-TargetNodeCommunicationMode <NodeCommunicationMode>]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet New-AzBatchPool crea un grupo en el servicio Azure Batch en la cuenta especificada por el parámetro BatchContext .
Ejemplos
Ejemplo 1: Creación de un nuevo grupo mediante el conjunto de parámetros TargetDedicated mediante CloudServiceConfiguration
$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSCloudServiceConfiguration" -ArgumentList @(4,"*")
New-AzBatchPool -Id "MyPool" -VirtualMachineSize "STANDARD_D1_V2" -CloudServiceConfiguration $configuration -TargetDedicatedComputeNodes 3 -BatchContext $Context
El grupo está configurado para usar STANDARD_D1_V2 máquinas virtuales con la versión del sistema operativo de la familia cuatro.
Ejemplo 2: Creación de un nuevo grupo mediante el conjunto de parámetros TargetDedicated mediante VirtualMachineConfiguration
$imageReference = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSImageReference" -ArgumentList @("WindowsServer", "MicrosoftWindowsServer", "2016-Datacenter", "*")
$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSVirtualMachineConfiguration" -ArgumentList @($imageReference, "batch.node.windows amd64")
New-AzBatchPool -Id "MyPool" -VirtualMachineSize "STANDARD_D1_V2" -VirtualMachineConfiguration $configuration -TargetDedicatedComputeNodes 3 -BatchContext $Context
Este comando crea un nuevo grupo con id. MyPool mediante el conjunto de parámetros TargetDedicated. La asignación de destino es tres nodos de proceso. El grupo está configurado para usar STANDARD_D1_V2 máquinas virtuales con la imagen del sistema operativo Windows-2016-Datacenter.
Ejemplo 3: Creación de un nuevo grupo mediante el conjunto de parámetros De escalabilidad automática
$imageReference = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSImageReference" -ArgumentList @("WindowsServer", "MicrosoftWindowsServer", "2016-Datacenter", "*")
$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSVirtualMachineConfiguration" -ArgumentList @($imageReference, "batch.node.windows amd64")
New-AzBatchPool -Id "AutoScalePool" -VirtualMachineSize "STANDARD_D1_V2" -VirtualMachineConfiguration $configuration -AutoScaleFormula '$TargetDedicated=2;' -BatchContext $Context
Este comando crea un nuevo grupo con id. AutoScalePool mediante el conjunto de parámetros AutoScale. El grupo está configurado para usar STANDARD_D1_V2 máquinas virtuales con la imagen del sistema operativo Windows-2016-Datacenter y la fórmula de escalado automático determina el número de nodos de proceso de destino.
Ejemplo 4: Creación de un grupo con nodos en una subred
$imageReference = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSImageReference" -ArgumentList @("WindowsServer", "MicrosoftWindowsServer", "2016-Datacenter", "*")
$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSVirtualMachineConfiguration" -ArgumentList @($imageReference, "batch.node.windows amd64")
$networkConfig = New-Object Microsoft.Azure.Commands.Batch.Models.PSNetworkConfiguration
$networkConfig.SubnetId = "/subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}"
New-AzBatchPool -Id "AutoScalePool" -VirtualMachineSize "STANDARD_D1_V2" -VirtualMachineConfiguration $configuration -TargetDedicatedComputeNodes 3 -NetworkConfiguration $networkConfig -BatchContext $Context
Ejemplo 5: Creación de un grupo con cuentas de usuario personalizadas
$imageReference = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSImageReference" -ArgumentList @("WindowsServer", "MicrosoftWindowsServer", "2016-Datacenter", "*")
$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSVirtualMachineConfiguration" -ArgumentList @($imageReference, "batch.node.windows amd64")
$userAccount = New-Object Microsoft.Azure.Commands.Batch.Models.PSUserAccount -ArgumentList @("myaccount", "mypassword")
New-AzBatchPool -Id "AutoScalePool" -VirtualMachineSize "STANDARD_D1_V2" -VirtualMachineConfiguration $configuration -TargetDedicatedComputeNodes 3 -UserAccount $userAccount
Parámetros
-ApplicationLicenses
La lista de licencias de aplicación que el servicio Batch pondrá a disposición en cada nodo de proceso del grupo.
Tipo: | List<T>[String] |
Aliases: | ApplicationLicense |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationPackageReferences
Tipo: | PSApplicationPackageReference[] |
Aliases: | ApplicationPackageReference |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScaleEvaluationInterval
Especifica la cantidad de tiempo, en minutos, que transcurre antes de que el tamaño del grupo se ajuste automáticamente según la fórmula de escalabilidad automática. El valor predeterminado es 15 minutos y el valor mínimo es de 5 minutos.
Tipo: | Nullable<T>[TimeSpan] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScaleFormula
Especifica la fórmula para escalar automáticamente el grupo.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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 |
-CertificateReferences
Especifica los certificados asociados al grupo. El servicio Batch instala los certificados a los que se hace referencia en cada nodo de proceso del grupo.
Tipo: | PSCertificateReference[] |
Aliases: | CertificateReference |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CloudServiceConfiguration
Especifica las opciones de configuración de un grupo en función de la plataforma de servicios en la nube de Azure.
Tipo: | PSCloudServiceConfiguration |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valor predeterminado: | False |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CurrentNodeCommunicationMode
Modo de comunicación del grupo actual.
Tipo: | NodeCommunicationMode |
valores aceptados: | Default, Classic, Simplified |
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 grupo.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifica el identificador del grupo que se va a crear.
Tipo: | String |
Position: | 0 |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InterComputeNodeCommunicationEnabled
Indica que este cmdlet configura el grupo para la comunicación directa entre nodos de proceso dedicados.
Tipo: | SwitchParameter |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Metadata
Especifica los metadatos, como pares clave-valor, para agregar al nuevo grupo. 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 |
-MountConfiguration
Lista de sistemas de archivos que se van a montar en cada nodo del grupo. Esto admite Azure Files, NFS, CIFS/SMB y Blobfuse.
Tipo: | PSMountConfiguration[] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NetworkConfiguration
La configuración de red para el grupo.
Tipo: | PSNetworkConfiguration |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResizeTimeout
Especifica el tiempo de espera para asignar nodos de proceso al grupo.
Tipo: | Nullable<T>[TimeSpan] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceTag
Las etiquetas definidas por el usuario que se van a asociar al grupo de Azure Batch.Cuando se especifica, estas etiquetas se propagan a los recursos de Azure de respaldo asociados al grupo. Esta propiedad solo se puede especificar cuando se creó la cuenta de Batch con la propiedad poolAllocationMode establecida en "UserSubscription".
Tipo: | IDictionary |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StartTask
Especifica la especificación de la tarea de inicio para el grupo. La tarea de inicio se ejecuta cuando un nodo de proceso se une al grupo o cuando el nodo de proceso se reinicia o se vuelve a crear una imagen de imagen.
Tipo: | PSStartTask |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TargetDedicatedComputeNodes
Especifica el número de destino de nodos de proceso dedicados que se van a asignar al grupo.
Tipo: | Nullable<T>[Int32] |
Aliases: | TargetDedicated |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TargetLowPriorityComputeNodes
Especifica el número de destino de nodos de proceso de prioridad baja que se van a asignar al grupo.
Tipo: | Nullable<T>[Int32] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TargetNodeCommunicationMode
Modo de comunicación de nodo deseado para el grupo.
Tipo: | NodeCommunicationMode |
valores aceptados: | Default, Classic, Simplified |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskSchedulingPolicy
Especifica la directiva de programación de tareas, como ComputeNodeFillType.
Tipo: | PSTaskSchedulingPolicy |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskSlotsPerNode
El número de ranuras de tareas que pueden usarse para ejecutar tareas simultáneas en un solo nodo de ejecución en el grupo. El valor predeterminado es 1. El valor máximo es el menor de 4 veces el número de núcleos de vmSize del grupo o 256.
Tipo: | Nullable<T>[Int32] |
Aliases: | MaxTasksPerComputeNode |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradePolicy
Directiva de actualización del grupo en NewBatchPoolCommand.cs .
Tipo: | PSUpgradePolicy |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserAccount
Lista de cuentas de usuario que se van a crear en cada nodo del grupo.
Tipo: | PSUserAccount[] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualMachineConfiguration
Especifica las opciones de configuración de un grupo en la infraestructura de máquinas virtuales.
Tipo: | PSVirtualMachineConfiguration |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualMachineSize
Especifica el tamaño de las máquinas virtuales del grupo. Para más información sobre los tamaños de máquina virtual, consulte Tamaños de máquinas virtuales en el sitio de Microsoft Azure.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valor predeterminado: | False |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Salidas
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de