Condividi tramite


az batch pool

Nota

Questo gruppo di comandi include comandi definiti sia nell'interfaccia della riga di comando di Azure che in almeno un'estensione. Installare ogni estensione per trarre vantaggio dalle funzionalità estese. Altre informazioni sulle estensioni.

Gestire i pool di Batch.

Comandi

Nome Descrizione Tipo Status
az batch pool autoscale

Gestire il ridimensionamento automatico dei pool di Batch.

Memoria centrale Disponibilità generale
az batch pool autoscale disable

Disabilita il ridimensionamento automatico per un pool.

Memoria centrale Disponibilità generale
az batch pool autoscale enable

Abilita il ridimensionamento automatico per un pool.

Memoria centrale Disponibilità generale
az batch pool autoscale evaluate

Ottiene il risultato della valutazione di una formula di ridimensionamento automatico nel pool.

Memoria centrale Disponibilità generale
az batch pool create

Creare un pool di Batch in un account. Quando si crea un pool, scegliere gli argomenti da Servizi cloud Configurazione o Configurazione macchina virtuale.

Memoria centrale Disponibilità generale
az batch pool create (azure-batch-cli-extensions estensione)

Creare un pool di Batch in un account. Quando si crea un pool, scegliere gli argomenti da Servizi cloud Configurazione o Configurazione macchina virtuale.

Estensione Disponibilità generale
az batch pool delete

Elimina un pool dall'account specificato.

Memoria centrale Disponibilità generale
az batch pool list

Elenca tutti i pool nell'account specificato.

Memoria centrale Disponibilità generale
az batch pool node-counts

Ottenere i conteggi dei nodi per i pool di Batch.

Memoria centrale Disponibilità generale
az batch pool node-counts list

Ottiene il numero di nodi di calcolo in ogni stato, raggruppati per pool.

Memoria centrale Disponibilità generale
az batch pool reset

Aggiornare le proprietà di un pool di Batch. Le proprietà non specificate che possono essere aggiornate vengono reimpostate sulle impostazioni predefinite.

Memoria centrale Disponibilità generale
az batch pool resize

Ridimensionare o arrestare il ridimensionamento di un pool di Batch.

Memoria centrale Disponibilità generale
az batch pool set

Aggiornare le proprietà di un pool di Batch. L'aggiornamento di una proprietà in un sottogruppo reimposta le proprietà non specificate di tale gruppo.

Memoria centrale Disponibilità generale
az batch pool show

Ottiene informazioni sul pool specificato.

Memoria centrale Disponibilità generale
az batch pool supported-images

Eseguire query sulle immagini di macchine virtuali supportate dal servizio Azure Batch.

Memoria centrale Disponibilità generale
az batch pool supported-images list

Elenca tutte le immagini di macchine virtuali supportate dal servizio Azure Batch.

Memoria centrale Disponibilità generale
az batch pool usage-metrics

Visualizzare le metriche di utilizzo dei pool di Batch.

Memoria centrale Disponibilità generale
az batch pool usage-metrics list

Elenca le metriche di utilizzo, aggregate per pool in intervalli di tempo individuali, per l'account specificato.

Memoria centrale Disponibilità generale

az batch pool create

Creare un pool di Batch in un account. Quando si crea un pool, scegliere gli argomenti da Servizi cloud Configurazione o Configurazione macchina virtuale.

az batch pool create [--accelerated-networking {false, true}]
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--application-licenses]
                     [--application-package-references]
                     [--auto-scale-formula]
                     [--certificate-references]
                     [--defer-os-rolling-upgrade {false, true}]
                     [--disable-auto-rollback {false, true}]
                     [--disk-encryption-targets]
                     [--enable-auto-os-upgrade {false, true}]
                     [--enable-cross-zone-upgrade {false, true}]
                     [--enable-inter-node-communication]
                     [--enable-secure-boot {false, true}]
                     [--enable-vtpm {false, true}]
                     [--enable-write-accel {false, true}]
                     [--encryption-at-host {false, true}]
                     [--id]
                     [--image]
                     [--json-file]
                     [--max-batch-instance-percent]
                     [--max-unhealthy-instance-percent]
                     [--max-unhealthy-upgraded-instance-percent]
                     [--metadata]
                     [--node-agent-sku-id]
                     [--os-disk-caching {none, readonly, readwrite}]
                     [--os-disk-size]
                     [--os-family {2, 3, 4, 5, 6}]
                     [--os-version]
                     [--pause-time-between-batches]
                     [--placement {cachedisk}]
                     [--policy {regional, zonal}]
                     [--prioritize-unhealthy-instances {false, true}]
                     [--resize-timeout]
                     [--resource-tags]
                     [--rollback-failed-instances-on-policy-breach {false, true}]
                     [--security-type]
                     [--start-task-command-line]
                     [--start-task-resource-files]
                     [--start-task-wait-for-success]
                     [--storage-account-type {premium_lrs, standard_lrs, standardssd_lrs}]
                     [--target-communication {classic, default, simplified}]
                     [--target-dedicated-nodes]
                     [--target-low-priority-nodes]
                     [--targets]
                     [--task-slots-per-node]
                     [--upgrade-policy-mode {automatic, manual, rolling}]
                     [--use-rolling-upgrade-policy {false, true}]
                     [--vm-size]

Parametri facoltativi

--accelerated-networking

Indica se il pool deve abilitare la rete accelerata. La rete accelerata consente la virtualizzazione di I/O radice singola (SR-IOV) a una macchina virtuale, con un miglioramento delle prestazioni di rete. Per altri dettagli, vedere Network https://learn.microsoft.com/azure/virtual- /accelerated-networking-overview. Impostare true per abilitare.

Valori accettati: false, true
--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--application-licenses

L'elenco delle licenze dell'applicazione deve essere un subset di licenze dell'applicazione di servizio Batch disponibili. Se viene richiesta una licenza non supportata, la creazione del pool avrà esito negativo. Valori separati da spazi.

--application-package-references

Quando si crea un pool, l'ID applicazione del pacchetto deve essere completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Le modifiche apportate ai riferimenti ai pacchetti influiscono su tutti i nuovi nodi che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool fino a quando non vengono riavviati o ricreati l'immagine. È previsto un massimo di 10 riferimenti al pacchetto in un determinato pool. ID applicazione separati da spazi con versione facoltativa nel formato "id[#version]".

--auto-scale-formula

Formula per il numero desiderato di nodi di calcolo nel pool. La formula viene verificata per la validità prima della creazione del pool. Se la formula non è valida, il servizio Batch rifiuta la richiesta con informazioni dettagliate sull'errore. Per altre informazioni sulla specifica di questa formula, vedere https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/.

--certificate-references

Per i nodi Di Windows, il servizio Batch installa i certificati nell'archivio certificati e nel percorso specificati. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire una query per questo percorso. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente (ad esempio, /home/{user-name}/certs) e i certificati vengono inseriti in tale directory. Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece l'estensione Azure KeyVault. Identificazioni personali del certificato separate da spazi.

--defer-os-rolling-upgrade

Rinviare gli aggiornamenti del sistema operativo nelle macchine virtuali se eseguono attività. True se il flag è presente.

Valori accettati: false, true
--disable-auto-rollback

Indica se la funzionalità di rollback dell'immagine del sistema operativo deve essere disabilitata. True se il flag è presente.

Valori accettati: false, true
--disk-encryption-targets

Elenco separato da spazi di DiskEncryptionTargets. i valori possibili correnti includono OsDisk e TemporaryDisk.

--enable-auto-os-upgrade

Indica se gli aggiornamenti del sistema operativo devono essere applicati automaticamente alle istanze del set di scalabilità in sequenza quando diventa disponibile una versione più recente dell'immagine del sistema operativo.

Se è impostato su true per i pool basati su Windows, WindowsConfiguration.enableAutomatic Aggiornamenti non può essere impostato su true. True se il flag è presente.

Valori accettati: false, true
--enable-cross-zone-upgrade

Consentire al set di scalabilità di macchine virtuali di ignorare i limiti az durante la creazione di batch di aggiornamento. Prendere in considerazione il dominio di aggiornamento e maxBatchInstancePercent per determinare le dimensioni del batch. Questo campo può essere impostato su true o false solo quando si usa NodePlacementConfiguration come Zonal. True se il flag è presente.

Valori accettati: false, true
--enable-inter-node-communication

Indica se il pool consente la comunicazione diretta tra nodi di calcolo. L'abilitazione della comunicazione tra nodi limita le dimensioni massime del pool a causa delle restrizioni di distribuzione nei nodi di calcolo del pool. Ciò può comportare che il pool non raggiunga le dimensioni desiderate. Il valore predefinito è false. True se il flag è presente.

--enable-secure-boot

Abilitare l'avvio protetto.

Valori accettati: false, true
--enable-vtpm

Abilitare vTPM.

Valori accettati: false, true
--enable-write-accel

Specificare se writeAccelerator deve essere abilitato o disabilitato sul disco.

Valori accettati: false, true
--encryption-at-host

Questa proprietà può essere usata dall'utente nella richiesta per abilitare o disabilitare la crittografia host per la macchina virtuale o il set di scalabilità di macchine virtuali. In questo modo verrà abilitata la crittografia per tutti i dischi, incluso il disco Resource/Temp nell'host stesso. Il comportamento predefinito è: la crittografia dell'host verrà disabilitata a meno che questa proprietà non sia impostata su true per la risorsa.

Valori accettati: false, true
--id

Obbligatorio. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri. L'ID mantiene la distinzione tra maiuscole e minuscole e non fa distinzione tra maiuscole e minuscole, ovvero potrebbe non avere due ID pool all'interno di un account che differisce solo per caso.

--image

Informazioni di riferimento sulle immagini del sistema operativo. Può trattarsi del formato 'publisher:offer:sku[:version]' o di un ID immagine ARM completo del formato '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}'. Se il formato 'publisher:offer:sku[:version]' è facoltativo e se omesso verrà usato più recente. I valori validi possono essere recuperati tramite 'az batch pool supported-images list'. Ad esempio: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".

--json-file

Il file contenente il pool crea la specifica del parametro delle proprietà in JSON (formattato in modo che corrisponda al corpo della richiesta dell'API REST). Se questo parametro viene specificato, tutti gli argomenti 'Pool Create Properties Parameters' vengono ignorati. Vedere https://docs.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#request-body.

--max-batch-instance-percent

Percentuale massima delle istanze totali di macchine virtuali che verranno aggiornate contemporaneamente dall'aggiornamento in sequenza in un unico batch. Poiché si tratta di un valore massimo, le istanze non integre nei batch precedenti o futuri possono causare la diminuzione della percentuale di istanze in un batch per garantire una maggiore affidabilità. Il valore di questo campo deve essere compreso tra 5 e 100 inclusi. Se vengono assegnati sia maxBatchInstancePercent che maxUnhealthyInstancePercent con valore, il valore di maxBatchInstancePercent non deve essere maggiore di maxUnhealthyInstancePercent.

--max-unhealthy-instance-percent

Percentuale massima delle istanze totali della macchina virtuale nel set di scalabilità che possono essere contemporaneamente non integre, in seguito all'aggiornamento o rilevate in uno stato non integro dai controlli di integrità della macchina virtuale prima dell'interruzione dell'aggiornamento in sequenza. Questo vincolo verrà controllato prima di avviare qualsiasi batch. Il valore di questo campo deve essere compreso tra 5 e 100 inclusi. Se vengono assegnati sia maxBatchInstancePercent che maxUnhealthyInstancePercent con valore, il valore di maxBatchInstancePercent non deve essere maggiore di maxUnhealthyInstancePercent.

--max-unhealthy-upgraded-instance-percent

Percentuale massima di istanze di macchina virtuale aggiornate che possono essere trovate in uno stato non integro. Questo controllo verrà eseguito dopo l'aggiornamento di ogni batch. Se questa percentuale viene mai superata, l'aggiornamento in sequenza viene interrotto. Il valore di questo campo deve essere compreso tra 0 e 100 inclusi.

--metadata

Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente. Valori separati da spazi nel formato 'key=value'.

--node-agent-sku-id

Obbligatorio. L'agente del nodo di calcolo batch è un programma che viene eseguito in ogni nodo di calcolo nel pool e fornisce l'interfaccia di comando e controllo tra il nodo di calcolo e il servizio Batch. Esistono implementazioni diverse dell'agente del nodo di calcolo, note come SKU, per sistemi operativi diversi. È necessario specificare uno SKU dell'agente del nodo di calcolo corrispondente al riferimento immagine selezionato. Per ottenere l'elenco degli SKU dell'agente del nodo di calcolo supportati insieme al relativo elenco di riferimenti alle immagini verificate, vedere l'operazione "Elenca gli SKU dell'agente del nodo di calcolo supportati".

--os-disk-caching

Specificare i requisiti di memorizzazione nella cache. I valori possibili sono: Nessuno, ReadOnly, ReadWrite. I valori predefiniti sono: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.

Valori accettati: none, readonly, readwrite
--os-disk-size

Dimensioni iniziali del disco in GB durante la creazione di un nuovo disco del sistema operativo.

--os-family

Obbligatorio. I valori possibili sono: 2 - Famiglia di sistemi operativi 2, equivalente a Windows Server 2008 R2 SP1. 3 - Famiglia di sistemi operativi 3, equivalente a Windows Server 2012. 4 - Famiglia di sistemi operativi 4, equivalente a Windows Server 2012 R2. 5 - Famiglia di sistemi operativi 5, equivalente a Windows Server 2016. 6 - Famiglia di sistemi operativi 6, equivalente a Windows Server 2019. Per altre informazioni, vedere Versioni del sistema operativo guest di Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).

Valori accettati: 2, 3, 4, 5, 6
--os-version

Il valore predefinito è * che specifica la versione più recente del sistema operativo per la famiglia di sistemi operativi specificata.

--pause-time-between-batches

Tempo di attesa tra il completamento dell'aggiornamento per tutte le macchine virtuali in un batch e l'avvio del batch successivo. La durata dell'ora deve essere specificata nel formato ISO 8601. Il formato previsto è una durata ISO-8601.

--placement

Specifica il posizionamento temporaneo del disco per il disco del sistema operativo per tutte le macchine virtuali nel pool. Questa proprietà può essere usata dall'utente nella richiesta per scegliere il percorso, ad esempio lo spazio su disco della cache per il provisioning temporaneo del disco del sistema operativo. Per altre informazioni sui requisiti delle dimensioni del disco del sistema operativo temporaneo, vedere Requisiti delle dimensioni del disco del sistema operativo temporaneo per le macchine virtuali Windows in https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e macchine virtuali Linux all'indirizzo https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

Valori accettati: cachedisk
--policy

Tipo di criteri di posizionamento dei nodi nei pool batch. Criteri di allocazione usati dal servizio Batch per effettuare il provisioning dei nodi. Se non specificato, Batch userà i criteri internazionali.

Valori accettati: regional, zonal
--prioritize-unhealthy-instances

Aggiornare tutte le istanze non integre in un set di scalabilità prima di qualsiasi istanza integra. True se il flag è presente.

Valori accettati: false, true
--resize-timeout

Questo timeout si applica solo alla scalabilità manuale; non ha alcun effetto quando enableAutoScale è impostato su true. Il valore predefinito è 15 minuti. Il valore minimo è 5 minuti. Se si specifica un valore inferiore a 5 minuti, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida). Il formato previsto è una durata ISO-8601.

--resource-tags

L'utente è in grado di specificare i tag delle risorse per il pool. Qualsiasi risorsa creata per il pool verrà quindi contrassegnata anche con gli stessi tag di risorsa.

--rollback-failed-instances-on-policy-breach

Il rollback delle istanze non riuscite nel modello precedente se i criteri di aggiornamento in sequenza vengono violati. True se il flag è presente.

Valori accettati: false, true
--security-type

Specificare il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare Uefi Impostazioni. Il comportamento predefinito è: Uefi Impostazioni non verrà abilitato a meno che questa proprietà non sia impostata.

--start-task-command-line

Obbligatorio. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (relativo alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--start-task-resource-files

I file elencati in questo elemento si trovano nella directory di lavoro dell'attività. Riferimenti a risorse separate da spazi in formato filename=httpurl.

--start-task-wait-for-success

Indica se il servizio Batch deve attendere il completamento di StartTask( ovvero uscire con il codice di uscita 0) prima di pianificare qualsiasi attività nel nodo di calcolo. Se true e StartTask non riesce in un nodo, il servizio Batch ritenta l'avvio fino al numero massimo di tentativi (maxTaskRetryCount). Se l'attività non è ancora stata completata correttamente dopo tutti i tentativi, il servizio Batch contrassegna il nodo inutilizzabile e non pianifica attività. Questa condizione può essere rilevata tramite lo stato del nodo di calcolo e i dettagli dell'errore. Se false, il servizio Batch non attenderà il completamento di StartTask. In questo caso, è possibile avviare l'esecuzione di altre attività nel nodo di calcolo mentre StartTask è ancora in esecuzione; e anche se StartTask ha esito negativo, le nuove attività continueranno a essere pianificate nel nodo di calcolo. Il valore predefinito è true. True se il flag è presente.

--storage-account-type

Tipo di account di archiviazione per il disco gestito.

Valori accettati: premium_lrs, standard_lrs, standardssd_lrs
--target-communication

Modalità di comunicazione del nodo desiderata per il pool. Se questo elemento è presente, sostituisce il targetNodeCommunicationMode esistente configurato nel pool. Se omesso, i metadati esistenti vengono lasciati invariati.

Valori accettati: classic, default, simplified
--target-dedicated-nodes

Numero desiderato di nodi di calcolo dedicati nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.

--target-low-priority-nodes

Numero desiderato di nodi di calcolo spot/con priorità bassa nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.

--targets

Se omesso, non verrà crittografato alcun disco nei nodi di calcolo nel pool. Nel pool Linux è supportato solo "TemporaryDisk". nel pool di Windows è necessario specificare "OsDisk" e "TemporaryDisk". Dischi di destinazione separati da crittografare. I valori possono essere OsDisk o TemporaryDisk.

--task-slots-per-node

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.

--upgrade-policy-mode

Modalità di aggiornamento del sistema operativo del pool.

Valori accettati: automatic, manual, rolling
--use-rolling-upgrade-policy

Indica se i criteri di aggiornamento in sequenza devono essere usati durante l'aggiornamento automatico del sistema operativo. L'aggiornamento automatico del sistema operativo eseguirà il fallback ai criteri predefiniti se non sono definiti criteri nel set di scalabilità di macchine virtuali. True se il flag è presente.

Valori accettati: false, true
--vm-size

Obbligatorio. Per informazioni sulle dimensioni disponibili delle macchine virtuali per i pool di Servizi cloud (pool creati con cloudServiceConfiguration), vedere Dimensioni per Servizi cloud (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch supporta tutte le dimensioni di vm Servizi cloud ad eccezione di ExtraSmall, A1V2 e A2V2. Per informazioni sulle dimensioni delle macchine virtuali disponibili per i pool che usano immagini dal Marketplace Macchine virtuali (pool creati con virtualMachineConfiguration), vedere Dimensioni per Macchine virtuali (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) o Dimensioni per Macchine virtuali (Windows).https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/ Batch supporta tutte le dimensioni delle macchine virtuali di Azure tranne STANDARD_A0 e quelle con archiviazione Premium (STANDARD_GS, STANDARD_DS e serie di STANDARD_DSV2).

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az batch pool create (azure-batch-cli-extensions estensione)

Creare un pool di Batch in un account. Quando si crea un pool, scegliere gli argomenti da Servizi cloud Configurazione o Configurazione macchina virtuale.

az batch pool create [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--application-licenses]
                     [--application-package-references]
                     [--auto-scale-formula]
                     [--certificate-references]
                     [--disk-encryption-targets]
                     [--enable-inter-node-communication]
                     [--id]
                     [--image]
                     [--json-file]
                     [--metadata]
                     [--node-agent-sku-id]
                     [--os-family]
                     [--os-version]
                     [--parameters]
                     [--policy]
                     [--resize-timeout]
                     [--resource-group]
                     [--start-task-command-line]
                     [--start-task-resource-files]
                     [--start-task-wait-for-success]
                     [--target-dedicated-nodes]
                     [--target-low-priority-nodes]
                     [--targets]
                     [--task-slots-per-node]
                     [--template]
                     [--vm-size]

Parametri facoltativi

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--application-licenses

L'elenco delle licenze dell'applicazione deve essere un subset di licenze dell'applicazione di servizio Batch disponibili. Se viene richiesta una licenza non supportata, la creazione del pool avrà esito negativo.

--application-package-references

Quando si crea un pool, l'ID applicazione del pacchetto deve essere completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Le modifiche apportate ai riferimenti ai pacchetti influiscono su tutti i nuovi nodi che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool fino a quando non vengono riavviati o ricreati l'immagine. È previsto un massimo di 10 riferimenti al pacchetto in un determinato pool.

--auto-scale-formula

Questa proprietà non deve essere specificata se enableAutoScale è impostato su false. È necessario se enableAutoScale è impostato su true. La formula viene verificata la validità prima della creazione del pool. Se la formula non è valida, il servizio Batch rifiuta la richiesta con informazioni dettagliate sull'errore. Per altre informazioni su come specificare questa formula, vedere "Ridimensionare automaticamente i nodi di calcolo in un pool di Azure Batch" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

--certificate-references

Per i nodi Di Windows, il servizio Batch installa i certificati nell'archivio certificati e nel percorso specificati. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire una query per questo percorso. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente (ad esempio, /home/{user-name}/certs) e i certificati vengono inseriti in tale directory. Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece l'estensione Azure KeyVault.

--disk-encryption-targets

Elenco di spazio separato di DiskEncryptionTargets. i valori possibili correnti includono OsDisk e TemporaryDisk.

--enable-inter-node-communication

Indica se il pool consente la comunicazione diretta tra nodi di calcolo. L'abilitazione della comunicazione tra nodi limita le dimensioni massime del pool a causa delle restrizioni di distribuzione nei nodi di calcolo del pool. Ciò può comportare che il pool non raggiunga le dimensioni desiderate. Il valore predefinito è false.

Valore predefinito: False
--id

Obbligatorio. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri. L'ID mantiene la distinzione tra maiuscole e minuscole e non fa distinzione tra maiuscole e minuscole, ovvero potrebbe non avere due ID pool all'interno di un account che differisce solo per caso.

--image

Informazioni di riferimento sulle immagini del sistema operativo. Può trattarsi del formato 'publisher:offer:sku[:version]' o di un ID immagine ARM completo del formato '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}'. Se il formato 'publisher:offer:sku[:version]' è facoltativo e se omesso verrà usato più recente. I valori validi possono essere recuperati tramite 'az batch pool node-agent-skus list'. Ad esempio: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".

--json-file

Il file contenente il pool da creare in formato JSON, se questo parametro viene specificato, tutti gli altri parametri vengono ignorati.

--metadata

Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.

--node-agent-sku-id

SKU dell'agente del nodo Batch di cui eseguire il provisioning nei nodi di calcolo nel pool. L'agente del nodo Batch è un programma che viene eseguito in ogni nodo del pool e fornisce l'interfaccia di comando e controllo tra il nodo e il servizio Batch. Sono disponibili diverse implementazioni dell'agente del nodo, definite SKU, per sistemi operativi diversi. È necessario specificare uno SKU dell'agente del nodo che corrisponde al riferimento all'immagine selezionata. Per ottenere l'elenco degli SKU dell'agente di nodi supportati insieme all'elenco dei riferimenti alle immagini verificate, vedere l'operazione "Elenca gli SKU dell'agente del nodo supportati".

--os-family

La famiglia del sistema operativo guest Azure da installare nelle macchine virtuali nel pool. I valori possibili sono: 2 - Famiglia di sistemi operativi 2, equivalente a Windows Server 2008 R2 SP1. 3 - Famiglia di sistemi operativi 3, equivalente a Windows Server 2012. 4 - Famiglia di sistemi operativi 4, equivalente a Windows Server 2012 R2. 5 - Famiglia di sistemi operativi 5, equivalente a Windows Server 2016. Per altre informazioni, vedere Versioni del sistema operativo guest di Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). Valori consentiti: 2, 3, 4, 5.

--os-version

Il valore predefinito è * che specifica la versione più recente del sistema operativo per la famiglia di sistemi operativi specificata.

--parameters

Valori dei parametri per un file modello JSON del pool batch. Può essere usato solo con --template.

--policy

Tipo di criteri di posizionamento dei nodi nei pool batch. Criteri di allocazione usati dal servizio Batch per effettuare il provisioning dei nodi. Se non specificato, Batch userà i criteri internazionali. Valori consentiti: area, zona.

--resize-timeout

Questo timeout si applica solo alla scalabilità manuale; non ha alcun effetto quando enableAutoScale è impostato su true. Il valore predefinito è 15 minuti. Il valore minimo è 5 minuti. Se si specifica un valore inferiore a 5 minuti, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).

--resource-group

Gruppo di risorse dell'account Batch.

--start-task-command-line

Riga di comando dell'attività di avvio. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux.

--start-task-resource-files

Elenco di file che il servizio Batch scaricherà nel nodo di calcolo prima di eseguire la riga di comando. Riferimenti a risorse separate da spazi nel formato filename=httpurl.

--start-task-wait-for-success

Indica se il servizio Batch deve attendere che l'attività di avvio venga completata correttamente( ovvero per uscire con il codice di uscita 0) prima di pianificare eventuali attività nel nodo di calcolo. Se true e l'attività di avvio non riesce in un nodo di calcolo, il servizio Batch ritenta l'attività di avvio fino al numero massimo di tentativi (maxTaskRetryCount). Se l'attività non è ancora stata completata correttamente dopo tutti i tentativi, il servizio Batch contrassegna il nodo di calcolo inutilizzabile e non pianifica le attività. Questa condizione può essere rilevata tramite lo stato del nodo e i dettagli degli errori di pianificazione. Se false, il servizio Batch non attenderà il completamento dell'attività di avvio. In questo caso, altre attività possono avviare l'esecuzione nel nodo di calcolo mentre l'attività di avvio è ancora in esecuzione; e anche se l'attività di avvio non riesce, le nuove attività continueranno a essere pianificate nel nodo. L'impostazione predefinita è false. True se il flag è presente.

Valore predefinito: False
--target-dedicated-nodes

Numero desiderato di nodi di calcolo dedicati nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.

--target-low-priority-nodes

Numero desiderato di nodi di calcolo spot/con priorità bassa nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.

--targets

Se omesso, non verrà crittografato alcun disco nei nodi di calcolo nel pool. Nel pool Linux è supportato solo "TemporaryDisk". nel pool di Windows è necessario specificare "OsDisk" e "TemporaryDisk". Dischi di destinazione separati da crittografare. I valori possono essere OsDisk o TemporaryDisk.

--task-slots-per-node

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.

--template

Un file di modello JSON del pool batch. Se si specifica questo parametro, tutti gli altri parametri vengono ignorati.

--vm-size

Obbligatorio. Per informazioni sulle dimensioni disponibili delle macchine virtuali per i pool di Servizi cloud (pool creati con cloudServiceConfiguration), vedere Dimensioni per Servizi cloud (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch supporta tutte le dimensioni di vm Servizi cloud ad eccezione di ExtraSmall, A1V2 e A2V2. Per informazioni sulle dimensioni delle macchine virtuali disponibili per i pool che usano immagini dal Marketplace Macchine virtuali (pool creati con virtualMachineConfiguration), vedere Dimensioni per Macchine virtuali (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) o Dimensioni per Macchine virtuali (Windows).https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/ Batch supporta tutte le dimensioni delle macchine virtuali di Azure tranne STANDARD_A0 e quelle con archiviazione Premium (STANDARD_GS, STANDARD_DS e serie di STANDARD_DSV2).

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az batch pool delete

Elimina un pool dall'account specificato.

Quando si richiede l'eliminazione di un pool, si verificano le azioni seguenti: lo stato pool è impostato per l'eliminazione; tutte le operazioni di ridimensionamento in corso sul pool vengono arrestate; il servizio Batch avvia il ridimensionamento del pool a zero nodi di calcolo; qualsiasi attività in esecuzione su nodi di calcolo esistenti viene terminata e accodata (come se fosse stata richiesta un'operazione di ridimensionamento del pool con l'opzione di accodamento predefinita); infine, il pool viene rimosso dal sistema. Poiché l'esecuzione di attività viene riquedata, l'utente può rieseguire queste attività aggiornando il processo in modo che venga usata come destinazione un pool diverso. Le attività possono quindi essere eseguite nel nuovo pool. Se si vuole eseguire l'override del comportamento di accodamento, è necessario chiamare ridimensionare il pool in modo esplicito per ridurre le dimensioni del pool a zero prima di eliminare il pool. Se si chiama un'API Update, Patch o Delete in un pool nello stato di eliminazione, l'operazione avrà esito negativo con codice di stato HTTP 409 con codice di errore PoolBeingDeleted.

az batch pool delete --pool-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--yes]

Parametri necessari

--pool-id

ID del pool da eliminare.

Parametri facoltativi

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--if-match

Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio corrisponde esattamente al valore specificato dal client.

--if-modified-since

Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio è stata modificata dall'ora specificata.

--if-none-match

Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio non corrisponde al valore specificato dal client.

--if-unmodified-since

Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio non è stata modificata dall'ora specificata.

--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az batch pool list

Elenca tutti i pool nell'account specificato.

az batch pool list [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--filter]
                   [--select]

Parametri facoltativi

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--expand

Clausola di $expand OData.

--filter

Clausola di $filter OData. Per altre informazioni sulla costruzione di questo filtro, vedere https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-pools.

--select

Clausola di $select OData.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az batch pool reset

Aggiornare le proprietà di un pool di Batch. Le proprietà non specificate che possono essere aggiornate vengono reimpostate sulle impostazioni predefinite.

az batch pool reset --pool-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--application-package-references]
                    [--certificate-references]
                    [--json-file]
                    [--metadata]
                    [--start-task-command-line]
                    [--start-task-environment-settings]
                    [--start-task-max-task-retry-count]
                    [--start-task-wait-for-success]

Parametri necessari

--pool-id

ID del pool da aggiornare.

Parametri facoltativi

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--application-package-references

Obbligatorio. L'elenco sostituisce tutti i riferimenti al pacchetto dell'applicazione esistenti nel pool. Le modifiche apportate ai riferimenti al pacchetto dell'applicazione influiscono su tutti i nuovi nodi di calcolo che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool finché non vengono riavviati o ricreati l'immagine. È previsto un massimo di 10 riferimenti al pacchetto dell'applicazione in un determinato pool. Se omesso o se si specifica una raccolta vuota, eventuali riferimenti ai pacchetti di applicazioni esistenti vengono rimossi dal pool. È possibile specificare un massimo di 10 riferimenti in un determinato pool.

--certificate-references

Obbligatorio. Questo elenco sostituisce tutti i riferimenti al certificato esistenti configurati nel pool. Se si specifica una raccolta vuota, tutti i riferimenti al certificato esistenti vengono rimossi dal pool. Per i nodi Di Windows, il servizio Batch installa i certificati nell'archivio certificati e nel percorso specificati. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire una query per questo percorso. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente (ad esempio, /home/{user-name}/certs) e i certificati vengono inseriti in tale directory. Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece l'estensione Azure KeyVault.

--json-file

File contenente la specifica del parametro delle proprietà di aggiornamento del pool in JSON (formattato in modo che corrisponda al corpo della richiesta dell'API REST). Se si specifica questo parametro, tutti gli argomenti del parametro 'Pool Update Properties Parameters' vengono ignorati.

--metadata

Obbligatorio. Questo elenco sostituisce tutti i metadati esistenti configurati nel pool. Se omesso o se si specifica una raccolta vuota, tutti i metadati esistenti vengono rimossi dal pool.

--start-task-command-line

Riga di comando dell'attività di avvio. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux.

--start-task-environment-settings

Elenco delle impostazioni delle variabili di ambiente per l'attività di avvio. Valori separati da spazi nel formato 'key=value'.

--start-task-max-task-retry-count

Numero massimo di tentativi consentiti per l'attività.

--start-task-wait-for-success

Indica se il servizio Batch deve attendere che l'attività di avvio venga completata correttamente( ovvero per uscire con il codice di uscita 0) prima di pianificare eventuali attività nel nodo di calcolo. True se il flag è presente. In caso contrario, l'impostazione predefinita è False.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az batch pool resize

Ridimensionare o arrestare il ridimensionamento di un pool di Batch.

az batch pool resize --pool-id
                     [--abort]
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--node-deallocation-option {requeue, retaineddata, taskcompletion, terminate}]
                     [--resize-timeout]
                     [--target-dedicated-nodes]
                     [--target-low-priority-nodes]

Parametri necessari

--pool-id

ID del pool.

Parametri facoltativi

--abort

Arrestare l'operazione di ridimensionamento del pool.

Valore predefinito: False
--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--if-match

L'operazione verrà eseguita solo se l'ETag corrente della risorsa corrisponde esattamente al valore specificato.

--if-modified-since

L'operazione verrà eseguita solo se la risorsa è stata modificata dopo il timestamp specificato.

--if-none-match

L'operazione non verrà eseguita solo se l'ETag corrente della risorsa corrisponde esattamente al valore specificato.

--if-unmodified-since

L'operazione non verrà eseguita solo se la risorsa è stata modificata dopo il timestamp specificato.

--node-deallocation-option

Quando i nodi possono essere rimossi dal pool, se le dimensioni del pool diminuiscono.

Valori accettati: requeue, retaineddata, taskcompletion, terminate
--resize-timeout

Il valore predefinito è 15 minuti. Il valore minimo è 5 minuti. Se si specifica un valore inferiore a 5 minuti, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).

--target-dedicated-nodes

Numero desiderato di nodi di calcolo dedicati nel pool.

--target-low-priority-nodes

Numero desiderato di nodi di calcolo spot/con priorità bassa nel pool.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az batch pool set

Aggiornare le proprietà di un pool di Batch. L'aggiornamento di una proprietà in un sottogruppo reimposta le proprietà non specificate di tale gruppo.

az batch pool set --pool-id
                  [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--application-package-references]
                  [--certificate-references]
                  [--if-match]
                  [--if-modified-since]
                  [--if-none-match]
                  [--if-unmodified-since]
                  [--json-file]
                  [--metadata]
                  [--start-task-command-line]
                  [--start-task-environment-settings]
                  [--start-task-max-task-retry-count]
                  [--start-task-resource-files]
                  [--start-task-wait-for-success]
                  [--target-communication {classic, default, simplified}]

Parametri necessari

--pool-id

ID del pool da aggiornare.

Parametri facoltativi

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--application-package-references

Le modifiche apportate ai riferimenti ai pacchetti influiscono su tutti i nuovi nodi che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool fino a quando non vengono riavviati o ricreati l'immagine. Se questo elemento è presente, sostituisce eventuali riferimenti al pacchetto esistenti. Se si specifica una raccolta vuota, tutti i riferimenti al pacchetto vengono rimossi dal pool. Se omesso, i riferimenti al pacchetto esistenti vengono lasciati invariati. ID applicazione separati da spazi con versione facoltativa nel formato "id[#version]".

--certificate-references

Se questo elemento è presente, sostituisce eventuali riferimenti al certificato esistenti configurati nel pool. Se omesso, i riferimenti al certificato esistenti vengono lasciati invariati. Per i nodi Di Windows, il servizio Batch installa i certificati nell'archivio certificati e nel percorso specificati. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire una query per questo percorso. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente (ad esempio, /home/{user-name}/certs) e i certificati vengono inseriti in tale directory. Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece l'estensione Azure KeyVault. Identificazioni personali del certificato separate da spazi.

--if-match

Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio corrisponde esattamente al valore specificato dal client.

--if-modified-since

Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio è stata modificata dall'ora specificata.

--if-none-match

Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio non corrisponde al valore specificato dal client.

--if-unmodified-since

Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio non è stata modificata dall'ora specificata.

--json-file

File contenente la specifica del parametro patch del pool in JSON (formattato in modo che corrisponda al rispettivo corpo dell'API REST). Se questo parametro viene specificato, tutti gli argomenti del pool vengono ignorati.

--metadata

Se questo elemento è presente, sostituisce tutti i metadati esistenti configurati nel pool. Se si specifica una raccolta vuota, tutti i metadati vengono rimossi dal pool. Se omesso, i metadati esistenti vengono lasciati invariati. Valori separati da spazi nel formato 'key=value'.

--start-task-command-line

Obbligatorio. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (relativo alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--start-task-environment-settings

Valori separati da spazi nel formato 'key=value'.

--start-task-max-task-retry-count

Numero massimo di tentativi dell'attività. Il servizio Batch ritenta un'attività se il codice di uscita è diverso da zero. Si noti che questo valore controlla specificamente il numero di tentativi. Il servizio Batch proverà l'attività una sola volta e potrebbe quindi riprovare fino a questo limite. Ad esempio, se il numero massimo di tentativi è 3, Batch prova l'attività fino a 4 volte (un tentativo iniziale e 3 tentativi). Se il numero massimo di tentativi è 0, il servizio Batch non ritenta l'attività. Se il numero massimo di tentativi è -1, il servizio Batch ritenta l'attività senza limite, ma non è consigliabile per un'attività di avvio o per qualsiasi attività. Il valore predefinito è 0, ovvero nessun tentativo.

--start-task-resource-files

I file elencati in questo elemento si trovano nella directory di lavoro dell'attività. Riferimenti a risorse separate da spazi in formato filename=httpurl.

--start-task-wait-for-success

Indica se il servizio Batch deve attendere il completamento di StartTask( ovvero uscire con il codice di uscita 0) prima di pianificare qualsiasi attività nel nodo di calcolo. Se true e StartTask non riesce in un nodo, il servizio Batch ritenta l'avvio fino al numero massimo di tentativi (maxTaskRetryCount). Se l'attività non è ancora stata completata correttamente dopo tutti i tentativi, il servizio Batch contrassegna il nodo inutilizzabile e non pianifica attività. Questa condizione può essere rilevata tramite lo stato del nodo di calcolo e i dettagli dell'errore. Se false, il servizio Batch non attenderà il completamento di StartTask. In questo caso, è possibile avviare l'esecuzione di altre attività nel nodo di calcolo mentre StartTask è ancora in esecuzione; e anche se StartTask ha esito negativo, le nuove attività continueranno a essere pianificate nel nodo di calcolo. Il valore predefinito è true. Specificare 'true' o 'false' per aggiornare la proprietà.

--target-communication

Modalità di comunicazione del nodo desiderata per il pool. Se questo elemento è presente, sostituisce il targetNodeCommunicationMode esistente configurato nel pool. Se omesso, i metadati esistenti vengono lasciati invariati.

Valori accettati: classic, default, simplified
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az batch pool show

Ottiene informazioni sul pool specificato.

az batch pool show --pool-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]
                   [--select]

Parametri necessari

--pool-id

ID del pool da ottenere.

Parametri facoltativi

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--expand

Clausola di $expand OData.

--if-match

Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio corrisponde esattamente al valore specificato dal client.

--if-modified-since

Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio è stata modificata dall'ora specificata.

--if-none-match

Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio non corrisponde al valore specificato dal client.

--if-unmodified-since

Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio non è stata modificata dall'ora specificata.

--select

Clausola di $select OData.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.