New-AzBatchPool

Module:: Az.Batch Module

Crée un pool dans le service Batch.

Syntaxe

CloudServiceAndTargetDedicated (Par défaut)

New-AzBatchPool
    [-Id] <String>
    -VirtualMachineSize <String>
    -BatchContext <BatchAccountContext>
    [-DisplayName <String>]
    [-ResizeTimeout <TimeSpan>]
    [-TargetDedicatedComputeNodes <Int32>]
    [-TargetLowPriorityComputeNodes <Int32>]
    [-TaskSlotsPerNode <Int32>]
    [-UpgradePolicy <PSUpgradePolicy>]
    [-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
    [-Metadata <IDictionary>]
    [-InterComputeNodeCommunicationEnabled]
    [-StartTask <PSStartTask>]
    [-ApplicationPackageReferences <PSApplicationPackageReference[]>]
    [-NetworkConfiguration <PSNetworkConfiguration>]
    [-MountConfiguration <PSMountConfiguration[]>]
    [-UserAccount <PSUserAccount[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

VirtualMachineAndTargetDedicated

New-AzBatchPool
    [-Id] <String>
    -VirtualMachineSize <String>
    -BatchContext <BatchAccountContext>
    [-DisplayName <String>]
    [-ResizeTimeout <TimeSpan>]
    [-TargetDedicatedComputeNodes <Int32>]
    [-TargetLowPriorityComputeNodes <Int32>]
    [-TaskSlotsPerNode <Int32>]
    [-UpgradePolicy <PSUpgradePolicy>]
    [-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
    [-Metadata <IDictionary>]
    [-InterComputeNodeCommunicationEnabled]
    [-StartTask <PSStartTask>]
    [-ApplicationPackageReferences <PSApplicationPackageReference[]>]
    [-VirtualMachineConfiguration <PSVirtualMachineConfiguration>]
    [-NetworkConfiguration <PSNetworkConfiguration>]
    [-MountConfiguration <PSMountConfiguration[]>]
    [-UserAccount <PSUserAccount[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CloudServiceAndAutoScale

New-AzBatchPool
    [-Id] <String>
    -VirtualMachineSize <String>
    -BatchContext <BatchAccountContext>
    [-DisplayName <String>]
    [-AutoScaleEvaluationInterval <TimeSpan>]
    [-AutoScaleFormula <String>]
    [-TaskSlotsPerNode <Int32>]
    [-UpgradePolicy <PSUpgradePolicy>]
    [-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
    [-Metadata <IDictionary>]
    [-InterComputeNodeCommunicationEnabled]
    [-StartTask <PSStartTask>]
    [-ApplicationPackageReferences <PSApplicationPackageReference[]>]
    [-NetworkConfiguration <PSNetworkConfiguration>]
    [-MountConfiguration <PSMountConfiguration[]>]
    [-UserAccount <PSUserAccount[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

VirtualMachineAndAutoScale

New-AzBatchPool
    [-Id] <String>
    -VirtualMachineSize <String>
    -BatchContext <BatchAccountContext>
    [-DisplayName <String>]
    [-AutoScaleEvaluationInterval <TimeSpan>]
    [-AutoScaleFormula <String>]
    [-TaskSlotsPerNode <Int32>]
    [-UpgradePolicy <PSUpgradePolicy>]
    [-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
    [-Metadata <IDictionary>]
    [-InterComputeNodeCommunicationEnabled]
    [-StartTask <PSStartTask>]
    [-ApplicationPackageReferences <PSApplicationPackageReference[]>]
    [-VirtualMachineConfiguration <PSVirtualMachineConfiguration>]
    [-NetworkConfiguration <PSNetworkConfiguration>]
    [-MountConfiguration <PSMountConfiguration[]>]
    [-UserAccount <PSUserAccount[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande New-AzBatchPool crée un pool dans le service Azure Batch sous le compte spécifié par le paramètre BatchContext .

Exemples

Exemple 1 : Créer un pool à l’aide du jeu de paramètres TargetDedicated à l’aide de 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

Cette commande crée un pool avec ID MyPool à l’aide du jeu de paramètres TargetDedicated. L’allocation cible est de trois nœuds de calcul. Le pool est configuré pour utiliser STANDARD_D1_V2 machines virtuelles avec l’image du système d’exploitation Windows-2016-Datacenter.

Exemple 2 : Créer un pool à l’aide du jeu de paramètres De mise à l’échelle automatique

$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

Cette commande crée un pool avec ID AutoScalePool à l’aide du jeu de paramètres AutoScale. Le pool est configuré pour utiliser STANDARD_D1_V2 machines virtuelles avec l’image du système d’exploitation Windows-2016-Datacenter, et le nombre cible de nœuds de calcul est déterminé par la formule de mise à l’échelle automatique.

Exemple 3 : Créer un pool avec des nœuds dans un sous-réseau

$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

Exemple 4 : Créer un pool avec des comptes d’utilisateur personnalisés

$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

Paramètres

-ApplicationPackageReferences

L’applet de commande New-AzBatchPool crée un pool dans le service Azure Batch sous le compte spécifié par le paramètre BatchContext .

Propriétés du paramètre

Type:	PSApplicationPackageReference[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	ApplicationPackageReference

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-AutoScaleEvaluationInterval

Spécifie la durée, en minutes, qui s’écoule avant que la taille du pool soit automatiquement ajustée en fonction de la formule de mise à l’échelle automatique. La valeur par défaut est de 15 minutes et la valeur minimale est de 5 minutes.

Propriétés du paramètre

Type:	Nullable<T>[TimeSpan]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

CloudServiceAndAutoScale

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

VirtualMachineAndAutoScale

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-AutoScaleFormula

Spécifie la formule permettant de mettre automatiquement à l’échelle le pool.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

CloudServiceAndAutoScale

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

VirtualMachineAndAutoScale

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-BatchContext

Spécifie l’instance BatchAccountContext utilisée par cette applet de commande pour interagir avec le service Batch. Si vous utilisez l’applet de commande Get-AzBatchAccount pour obtenir votre BatchAccountContext, l’authentification Microsoft Entra sera utilisée lors de l’interaction avec le service Batch. Pour utiliser l’authentification par clé partagée à la place, utilisez l’applet de commande Get-AzBatchAccountKey pour obtenir un objet BatchAccountContext avec ses clés d’accès remplies. Lorsque vous utilisez l’authentification par clé partagée, la clé d’accès primaire est utilisée par défaut. Pour modifier la clé à utiliser, définissez la propriété BatchAccountContext.KeyInUse.

Propriétés du paramètre

Type:	BatchAccountContext
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	cf

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:	IAzureContextContainer
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DisplayName

Spécifie le nom complet du pool.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Id

Spécifie l’ID du pool à créer.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-InterComputeNodeCommunicationEnabled

Indique que cette applet de commande configure le pool pour la communication directe entre les nœuds de calcul dédiés.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Metadata

Spécifie les métadonnées, en tant que paires clé/valeur, à ajouter au nouveau pool. La clé est le nom des métadonnées. La valeur est la valeur des métadonnées.

Propriétés du paramètre

Type:	IDictionary
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-MountConfiguration

Liste des systèmes de fichiers à monter sur chaque nœud du pool. Cela prend en charge Azure Files, NFS, CIFS/SMB et Blobfuse.

Propriétés du paramètre

Type:	PSMountConfiguration[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-NetworkConfiguration

Configuration réseau du pool.

Propriétés du paramètre

Type:	PSNetworkConfiguration
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ResizeTimeout

Spécifie le délai d’attente pour l’allocation de nœuds de calcul au pool.

Propriétés du paramètre

Type:	Nullable<T>[TimeSpan]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

CloudServiceAndTargetDedicated

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

VirtualMachineAndTargetDedicated

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-StartTask

Spécifie la spécification de la tâche de démarrage pour le pool. La tâche de démarrage est exécutée lorsqu’un nœud de calcul joint le pool, ou lorsque le nœud de calcul est redémarré ou réimagené.

Propriétés du paramètre

Type:	PSStartTask
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-TargetDedicatedComputeNodes

Spécifie le nombre cible de nœuds de calcul dédiés à allouer au pool.

Propriétés du paramètre

Type:	Nullable<T>[Int32]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	TargetDedicated

Jeux de paramètres

CloudServiceAndTargetDedicated

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

VirtualMachineAndTargetDedicated

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-TargetLowPriorityComputeNodes

Spécifie le nombre cible de nœuds de calcul de faible priorité à allouer au pool.

Propriétés du paramètre

Type:	Nullable<T>[Int32]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

CloudServiceAndTargetDedicated

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

VirtualMachineAndTargetDedicated

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-TaskSchedulingPolicy

Spécifie la stratégie de planification des tâches, telle que ComputeNodeFillType.

Propriétés du paramètre

Type:	PSTaskSchedulingPolicy
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-TaskSlotsPerNode

Nombre d’emplacements de tâche qui peuvent être utilisés pour exécuter des tâches simultanées sur un nœud de calcul unique dans le pool. La valeur par défaut est 1. La valeur maximale est la plus petite de 4 fois le nombre de cœurs de la vmSize du pool ou 256.

Propriétés du paramètre

Type:	Nullable<T>[Int32]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	MaxTasksPerComputeNode

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-UpgradePolicy

Stratégie de mise à niveau pour le pool dans NewBatchPoolCommand.cs .

Propriétés du paramètre

Type:	PSUpgradePolicy
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-UserAccount

Liste des comptes d’utilisateur à créer sur chaque nœud du pool.

Propriétés du paramètre

Type:	PSUserAccount[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-VirtualMachineConfiguration

Spécifie les paramètres de configuration d’un pool sur l’infrastructure des machines virtuelles.

Propriétés du paramètre

Type:	PSVirtualMachineConfiguration
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

VirtualMachineAndTargetDedicated

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

VirtualMachineAndAutoScale

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-VirtualMachineSize

Spécifie la taille des machines virtuelles dans le pool. Pour plus d’informations sur les tailles de machine virtuelle, consultez Tailles des machines virtuelles sur le site Microsoft Azure.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Wi

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Partager via

New-AzBatchPool

Syntaxe

CloudServiceAndTargetDedicated (Par défaut)

VirtualMachineAndTargetDedicated

CloudServiceAndAutoScale

VirtualMachineAndAutoScale

Description

Exemples

Exemple 1 : Créer un pool à l’aide du jeu de paramètres TargetDedicated à l’aide de VirtualMachineConfiguration

Exemple 2 : Créer un pool à l’aide du jeu de paramètres De mise à l’échelle automatique

Exemple 3 : Créer un pool avec des nœuds dans un sous-réseau

Exemple 4 : Créer un pool avec des comptes d’utilisateur personnalisés

Paramètres

-ApplicationPackageReferences

Propriétés du paramètre

Jeux de paramètres

-AutoScaleEvaluationInterval

Propriétés du paramètre

Jeux de paramètres

-AutoScaleFormula

Propriétés du paramètre

Jeux de paramètres

-BatchContext

Propriétés du paramètre

Jeux de paramètres

-Confirm

Propriétés du paramètre

Jeux de paramètres

-DefaultProfile

Propriétés du paramètre

Jeux de paramètres

-DisplayName

Propriétés du paramètre

Jeux de paramètres

-Id

Propriétés du paramètre

Jeux de paramètres

-InterComputeNodeCommunicationEnabled

Propriétés du paramètre

Jeux de paramètres

-Metadata

Propriétés du paramètre

Jeux de paramètres

-MountConfiguration

Propriétés du paramètre

Jeux de paramètres

-NetworkConfiguration

Propriétés du paramètre

Jeux de paramètres

-ResizeTimeout

Propriétés du paramètre

Jeux de paramètres

-StartTask

Propriétés du paramètre

Jeux de paramètres

-TargetDedicatedComputeNodes

Propriétés du paramètre

Jeux de paramètres

-TargetLowPriorityComputeNodes

Propriétés du paramètre

Jeux de paramètres

-TaskSchedulingPolicy

Propriétés du paramètre

Jeux de paramètres

-TaskSlotsPerNode

Propriétés du paramètre

Jeux de paramètres

-UpgradePolicy

Propriétés du paramètre

Jeux de paramètres

-UserAccount

Propriétés du paramètre

Jeux de paramètres

-VirtualMachineConfiguration

Propriétés du paramètre

Jeux de paramètres

-VirtualMachineSize

Propriétés du paramètre

Jeux de paramètres