New-AzBatchPool
Crea un pool nel servizio Batch.
Sintassi
CloudServiceAndTargetDedicated (Impostazione predefinita)
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>]
Descrizione
Il cmdlet New-AzBatchPool crea un pool nel servizio Azure Batch con l'account specificato dal parametro BatchContext .
Esempio
Esempio 1: Creare un nuovo pool usando il set di parametri TargetDedicated usando 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
Questo comando crea un nuovo pool con ID MyPool usando il set di parametri TargetDedicated.
L'allocazione di destinazione è di tre nodi di calcolo.
Il pool è configurato per l'uso di macchine virtuali STANDARD_D1_V2 con l'immagine del sistema operativo Windows-2016-Datacenter.
Esempio 2: Creare un nuovo pool usando il set di parametri di scalabilità automatica
$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
Questo comando crea un nuovo pool con ID AutoScalePool usando il set di parametri Di scalabilità automatica.
Il pool è configurato per l'uso di STANDARD_D1_V2 macchine virtuali con l'immagine del sistema operativo Windows-2016-Datacenter e il numero di destinazione dei nodi di calcolo è determinato dalla formula di scalabilità automatica.
Esempio 3: Creare un pool con nodi in una subnet
$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
Esempio 4: Creare un pool con account utente personalizzati
$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
Parametri
-ApplicationPackageReferences
Il cmdlet New-AzBatchPool crea un pool nel servizio Azure Batch con l'account specificato dal parametro BatchContext .
Proprietà dei parametri
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-AutoScaleEvaluationInterval
Specifica la quantità di tempo, espressa in minuti, trascorsa prima che le dimensioni del pool vengano regolate automaticamente in base alla formula di scalabilità automatica.
Il valore predefinito è 15 minuti e il valore minimo è 5 minuti.
Proprietà dei parametri
Tipo: Nullable<T> [ TimeSpan ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CloudServiceAndAutoScale
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
VirtualMachineAndAutoScale
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
Specifica la formula per il ridimensionamento automatico del pool.
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
CloudServiceAndAutoScale
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
VirtualMachineAndAutoScale
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-BatchContext
Specifica l'istanza batchAccountContext usata da questo cmdlet per interagire con il servizio Batch.
Se si usa il cmdlet Get-AzBatchAccount per ottenere BatchAccountContext, l'autenticazione di Microsoft Entra verrà usata durante l'interazione con il servizio Batch. Per usare invece l'autenticazione con chiave condivisa, usare il cmdlet Get-AzBatchAccountKey per ottenere un oggetto BatchAccountContext con le relative chiavi di accesso popolate. Quando si usa l'autenticazione con chiave condivisa, la chiave di accesso primaria viene usata per impostazione predefinita. Per modificare la chiave da usare, impostare la proprietà BatchAccountContext.KeyInUse.
Proprietà dei parametri
Tipo: BatchAccountContext
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: True
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: False
Supporta i caratteri jolly: False
DontShow: False
Alias: cfr
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
Proprietà dei parametri
Tipo: IAzureContextContainer
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: AzContext, AzureRmContext, AzureCredential
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-DisplayName
Specifica il nome visualizzato del pool.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-Id
Specifica l'ID del pool da creare.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: 0
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-InterComputeNodeCommunicationEnabled
Indica che questo cmdlet configura il pool per la comunicazione diretta tra nodi di calcolo dedicati.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
Specifica i metadati, come coppie chiave/valore, da aggiungere al nuovo pool.
La chiave è il nome dei metadati.
Il valore è il valore dei metadati.
Tipo: IDictionary
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-MountConfiguration
Elenco di file system da montare in ogni nodo del pool. Supporta File di Azure, NFS, CIFS/SMB e Blobfuse.
Proprietà dei parametri
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-NetworkConfiguration
Configurazione di rete per il pool.
Proprietà dei parametri
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-ResizeTimeout
Specifica il timeout per l'allocazione dei nodi di calcolo al pool.
Proprietà dei parametri
Tipo: Nullable<T> [ TimeSpan ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CloudServiceAndTargetDedicated
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
VirtualMachineAndTargetDedicated
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-StartTask
Specifica la specifica dell'attività di avvio per il pool.
L'attività di avvio viene eseguita quando un nodo di calcolo viene aggiunto al pool o quando il nodo di calcolo viene riavviato o ricreato l'immagine.
Proprietà dei parametri
Tipo: PSStartTask
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-TargetDedicatedComputeNodes
Specifica il numero di destinazione di nodi di calcolo dedicati da allocare al pool.
Proprietà dei parametri
Tipo: Nullable<T> [ Int32 ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: TargetDedicated
Set di parametri
CloudServiceAndTargetDedicated
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
VirtualMachineAndTargetDedicated
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-TargetLowPriorityComputeNodes
Specifica il numero di destinazione di nodi di calcolo con priorità bassa da allocare al pool.
Proprietà dei parametri
Tipo: Nullable<T> [ Int32 ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CloudServiceAndTargetDedicated
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
VirtualMachineAndTargetDedicated
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-TaskSchedulingPolicy
Specifica i criteri di pianificazione delle attività, ad esempio ComputeNodeFillType.
Proprietà dei parametri
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-TaskSlotsPerNode
Numero di slot di attività che possono essere usati per eseguire attività simultanee in un singolo nodo di calcolo nel pool.
Il valore predefinito è 1. Il valore massimo è minore di 4 volte il numero di core di vmSize del pool o 256.
Proprietà dei parametri
Tipo: Nullable<T> [ Int32 ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: MaxTasksPerComputeNode
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-UpgradePolicy
Criteri di aggiornamento per il pool in NewBatchPoolCommand.cs .
Proprietà dei parametri
Tipo: PSUpgradePolicy
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-UserAccount
Elenco di account utente da creare in ogni nodo del pool.
Proprietà dei parametri
Tipo: PSUserAccount [ ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-VirtualMachineConfiguration
Specifica le impostazioni di configurazione per un pool nell'infrastruttura delle macchine virtuali.
Proprietà dei parametri
Set di parametri
VirtualMachineAndTargetDedicated
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
VirtualMachineAndAutoScale
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-VirtualMachineSize
Specifica le dimensioni delle macchine virtuali nel pool.
Per altre informazioni sulle dimensioni delle macchine virtuali, vedere Dimensioni delle macchine virtuali nel sito di Microsoft Azure.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet.
Il cmdlet non viene eseguito.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: False
Supporta i caratteri jolly: False
DontShow: False
Alias: Wi
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters .
Output