az batch pool

Notitie

Deze opdrachtgroep bevat opdrachten die zijn gedefinieerd in zowel Azure CLI als ten minste één extensie. Installeer elke extensie om te profiteren van de uitgebreide mogelijkheden. Meer informatie over extensies.

Batch-pools beheren.

Opdracht

Name Description Type Status
az batch pool autoscale

Automatisch schalen van Batch-pools beheren.

Basis GA
az batch pool autoscale disable

Hiermee schakelt u automatisch schalen voor een pool uit.

Basis GA
az batch pool autoscale enable

Hiermee schakelt u automatisch schalen voor een pool in.

Basis GA
az batch pool autoscale evaluate

Hiermee haalt u het resultaat op van het evalueren van een formule voor automatisch schalen in de pool.

Basis GA
az batch pool create

Maak een Batch-pool in een account. Bij het maken van een pool kiest u argumenten uit Cloud Services-configuratie of configuratie van virtuele machines.

Basis GA
az batch pool create (azure-batch-cli-extensions extensie)

Maak een Batch-pool in een account. Bij het maken van een pool kiest u argumenten uit Cloud Services-configuratie of configuratie van virtuele machines.

Toestel GA
az batch pool delete

Hiermee verwijdert u een pool uit het opgegeven account.

Basis GA
az batch pool list

Een lijst met alle pools in het opgegeven account.

Basis GA
az batch pool node-counts

Haal het aantal knooppunten op voor Batch-pools.

Basis GA
az batch pool node-counts list

Hiermee haalt u het aantal rekenknooppunten in elke status op, gegroepeerd op pool.

Basis GA
az batch pool reset

Werk de eigenschappen van een Batch-pool bij. Niet-opgegeven eigenschappen die kunnen worden bijgewerkt, worden teruggezet naar de standaardwaarden.

Basis GA
az batch pool resize

Wijzig het formaat of stop het formaat van een Batch-pool.

Basis GA
az batch pool set

Werk de eigenschappen van een Batch-pool bij. Als u een eigenschap in een subgroep bijwerkt, worden de niet-opgegeven eigenschappen van die groep opnieuw ingesteld.

Basis GA
az batch pool show

Hiermee wordt informatie opgehaald over de opgegeven pool.

Basis GA
az batch pool supported-images

Query's uitvoeren op VM-installatiekopieën die worden ondersteund door de Azure Batch-service.

Basis GA
az batch pool supported-images list

Een lijst met alle installatiekopieën van virtuele machines die worden ondersteund door de Azure Batch-service.

Basis GA
az batch pool usage-metrics

Metrische gegevens over gebruik van Batch-pools weergeven.

Basis GA
az batch pool usage-metrics list

Geeft een lijst weer van de metrische gegevens over gebruik, geaggregeerd per pool met afzonderlijke tijdsintervallen, voor het opgegeven account.

Basis GA

az batch pool create

Maak een Batch-pool in een account. Bij het maken van een pool kiest u argumenten uit Cloud Services-configuratie of configuratie van virtuele machines.

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]

Optionele parameters

--accelerated-networking

Of deze pool versneld netwerken moet inschakelen. Versneld netwerken maakt I/O-virtualisatie met één hoofdmap (SR-IOV) mogelijk voor een VIRTUELE machine, wat kan leiden tot verbeterde netwerkprestaties. Zie voor meer informatie: https://learn.microsoft.com/azure/virtual- network/accelerated-networking-overview. Stel waar in om in te schakelen.

geaccepteerde waarden: false, true
--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--application-licenses

De lijst met toepassingslicenties moet een subset van beschikbare Licenties voor Batch-servicetoepassingen zijn. Als er een licentie wordt aangevraagd die niet wordt ondersteund, mislukt het maken van een pool. Door spaties gescheiden waarden.

--application-package-references

Bij het maken van een pool moet de toepassings-id van het pakket volledig zijn gekwalificeerd (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Wijzigingen in pakketverwijzingen zijn van invloed op alle nieuwe knooppunten die lid zijn van de pool, maar hebben geen invloed op rekenknooppunten die zich al in de pool bevinden totdat ze opnieuw worden opgestart of opnieuw worden hersteld. Er zijn maximaal 10 pakketverwijzingen voor een bepaalde groep. Toepassings-id's met optionele versie met de indeling id[#version].

--auto-scale-formula

Een formule voor het gewenste aantal rekenknooppunten in de pool. De formule wordt gecontroleerd op geldigheid voordat de pool wordt gemaakt. Als de formule niet geldig is, weigert de Batch-service de aanvraag met gedetailleerde foutinformatie. Zie voor meer informatie over het opgeven van deze formule https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/.

--certificate-references

Voor Windows-knooppunten installeert de Batch-service de certificaten op het opgegeven certificaatarchief en de opgegeven locatie. Voor Linux-rekenknooppunten worden de certificaten opgeslagen in een map in de werkmap Taak en wordt een omgevingsvariabele AZ_BATCH_CERTIFICATES_DIR aan de taak verstrekt om een query uit te voeren op deze locatie. Voor certificaten met zichtbaarheid van remoteUser wordt een map met certificaten gemaakt in de basismap van de gebruiker (bijvoorbeeld /home/{user-name}/certs) en certificaten worden in die map geplaatst. Waarschuwing: deze eigenschap is afgeschaft en wordt na februari 2024 verwijderd. Gebruik in plaats daarvan de Azure KeyVault-extensie . Vingerafdruk van door spaties gescheiden certificaten.

--defer-os-rolling-upgrade

Stel upgrades van het besturingssysteem uit op de TVM's als ze taken uitvoeren. Waar als er een vlag aanwezig is.

geaccepteerde waarden: false, true
--disable-auto-rollback

Of de functie voor terugdraaien van installatiekopieën van het besturingssysteem moet worden uitgeschakeld. Waar als er een vlag aanwezig is.

geaccepteerde waarden: false, true
--disk-encryption-targets

Een door spatie gescheiden lijst met DiskEncryptionTargets. huidige mogelijke waarden zijn OsDisk en TemporaryDisk.

--enable-auto-os-upgrade

Hiermee wordt aangegeven of upgrades van het besturingssysteem automatisch moeten worden toegepast op exemplaren van schaalsets wanneer een nieuwere versie van de installatiekopie van het besturingssysteem beschikbaar wordt.

Als dit is ingesteld op waar voor Windows-pools, kan WindowsConfiguration.enableAutomaticUpdates niet worden ingesteld op true. Waar als er een vlag aanwezig is.

geaccepteerde waarden: false, true
--enable-cross-zone-upgrade

Toestaan dat VMSS AZ-grenzen negeert bij het maken van upgradebatches. Neem rekening met het updatedomein en maxBatchInstancePercent om de batchgrootte te bepalen. Dit veld kan alleen worden ingesteld op waar of onwaar wanneer u NodePlacementConfiguration als zonegebonden gebruikt. Waar als er een vlag aanwezig is.

geaccepteerde waarden: false, true
--enable-inter-node-communication

Of de pool directe communicatie tussen rekenknooppunten toestaat. Als u communicatie tussen knooppunten inschakelt, wordt de maximale grootte van de pool beperkt vanwege implementatiebeperkingen op de rekenknooppunten van de pool. Dit kan ertoe leiden dat de pool de gewenste grootte niet bereikt. De standaardwaarde is false. Waar als er een vlag aanwezig is.

--enable-secure-boot

Schakel beveiligd opstarten in.

geaccepteerde waarden: false, true
--enable-vtpm

Schakel vTPM in.

geaccepteerde waarden: false, true
--enable-write-accel

Geef op of writeAccelerator moet worden ingeschakeld of uitgeschakeld op de schijf.

geaccepteerde waarden: false, true
--encryption-at-host

Deze eigenschap kan worden gebruikt door de gebruiker in de aanvraag om hostversleuteling voor de virtuele machine of virtuele-machineschaalset in of uit te schakelen. Hierdoor wordt de versleuteling ingeschakeld voor alle schijven, inclusief resource-/tijdelijke schijf op de host zelf. Het standaardgedrag is: De versleuteling op de host wordt uitgeschakeld, tenzij deze eigenschap is ingesteld op waar voor de resource.

geaccepteerde waarden: false, true
--id

Vereist. De id kan elke combinatie van alfanumerieke tekens bevatten, inclusief afbreekstreepjes en onderstrepingstekens, en mag niet meer dan 64 tekens bevatten. De id is hoofdlettergevoelig en niet hoofdlettergevoelig (dat wil gezegd, u hebt mogelijk geen twee pool-id's binnen een account die alleen per geval verschillen).

--image

Naslaginformatie over installatiekopieën van het besturingssysteem. Dit kan de indeling publisher:offer:sku[:version], of een volledig gekwalificeerde ARM-installatiekopieën-id zijn van het formulier /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}. Als de indeling publisher:offer:sku[:version], is de versie optioneel en wordt de meest recente weggelaten gebruikt. Geldige waarden kunnen worden opgehaald via 'az batch pool supported-images list'. Bijvoorbeeld: 'MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest'.

--json-file

Het bestand met de parameterspecificatie voor eigenschappen voor pool maken in JSON (opgemaakt om overeen te komen met de hoofdtekst van de REST API-aanvraag). Als deze parameter is opgegeven, worden alle parameterargumenten voor het maken van pooleigenschappen genegeerd. Zie https://docs.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#request-body.

--max-batch-instance-percent

Het maximumpercentage van het totale aantal exemplaren van virtuele machines dat tegelijkertijd wordt geüpgraded door de rolling upgrade in één batch. Omdat dit een maximum is, kunnen beschadigde exemplaren in eerdere of toekomstige batches ervoor zorgen dat het percentage exemplaren in een batch afneemt om een hogere betrouwbaarheid te garanderen. De waarde van dit veld moet tussen 5 en 100 liggen, inclusief. Als zowel maxBatchInstancePercent als maxUnhealthyInstancePercent aan waarde zijn toegewezen, mag de waarde van maxBatchInstancePercent niet meer zijn dan maxUnhealthyInstancePercent.

--max-unhealthy-instance-percent

Het maximumpercentage van het totale aantal exemplaren van virtuele machines in de schaalset dat tegelijkertijd beschadigd kan zijn, hetzij als gevolg van een upgrade of door de statuscontroles van de virtuele machine te worden aangetroffen voordat de rolling upgrade wordt afgebroken. Deze beperking wordt gecontroleerd voordat u een batch start. De waarde van dit veld moet tussen 5 en 100 liggen, inclusief. Als zowel maxBatchInstancePercent als maxUnhealthyInstancePercent aan waarde zijn toegewezen, mag de waarde van maxBatchInstancePercent niet meer zijn dan maxUnhealthyInstancePercent.

--max-unhealthy-upgraded-instance-percent

Het maximumpercentage van bijgewerkte exemplaren van virtuele machines die kunnen worden gevonden, hebben een slechte status. Deze controle vindt plaats nadat elke batch is bijgewerkt. Als dit percentage ooit wordt overschreden, wordt de rolling update afgebroken. De waarde van dit veld moet tussen 0 en 100, inclusief zijn.

--metadata

De Batch-service wijst geen betekenis toe aan metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode. Door spaties gescheiden waarden in de notatie 'key=value'.

--node-agent-sku-id

Vereist. De Batch Compute Node-agent is een programma dat wordt uitgevoerd op elk rekenknooppunt in de pool en biedt de opdracht-en-beheerinterface tussen het rekenknooppunt en de Batch-service. Er zijn verschillende implementaties van de Compute Node-agent, ook wel SKU's genoemd, voor verschillende besturingssystemen. U moet een rekenknooppuntagent-SKU opgeven die overeenkomt met de geselecteerde afbeeldingsreferentie. Zie de bewerking Ondersteunde SKU's voor compute-knooppuntagenten samen met de lijst met geverifieerde afbeeldingsverwijzingen voor de lijst met ondersteunde SKU's voor compute-knooppuntagenten.

--os-disk-caching

Geef de cachevereisten op. Mogelijke waarden zijn: Geen, ReadOnly, ReadWrite. De standaardwaarden zijn: Geen voor Standard-opslag. ReadOnly voor Premium-opslag.

geaccepteerde waarden: none, readonly, readwrite
--os-disk-size

De oorspronkelijke schijfgrootte in GB bij het maken van een nieuwe besturingssysteemschijf.

--os-family

Vereist. Mogelijke waarden zijn: 2 - OS Family 2, gelijk aan Windows Server 2008 R2 SP1. 3 - OS Family 3, gelijk aan Windows Server 2012. 4 - OS Family 4, gelijk aan Windows Server 2012 R2. 5 - OS Family 5, gelijk aan Windows Server 2016. 6 - Os Family 6, gelijk aan Windows Server 2019. Zie Releases van gastbesturingssystemen van Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases) voor meer informatie.

geaccepteerde waarden: 2, 3, 4, 5, 6
--os-version

De standaardwaarde is * waarmee de meest recente versie van het besturingssysteem voor de opgegeven besturingssysteemfamilie wordt opgegeven.

--pause-time-between-batches

De wachttijd tussen het voltooien van de update voor alle virtuele machines in één batch en het starten van de volgende batch. De tijdsduur moet worden opgegeven in ISO 8601-indeling. Verwachte indeling is een ISO-8601-duur.

--placement

Hiermee geeft u de tijdelijke schijfplaatsing voor besturingssysteemschijf voor alle VM's in de groep. Deze eigenschap kan worden gebruikt door de gebruiker in de aanvraag om de locatie te kiezen, bijvoorbeeld de cacheschijfruimte voor tijdelijke inrichting van besturingssysteemschijven. Raadpleeg voor meer informatie over tijdelijke besturingssysteemschijfgroottevereisten de vereisten voor tijdelijke besturingssysteemschijfgrootte voor Windows-VM's op https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements en Linux-VM's op https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

geaccepteerde waarden: cachedisk
--policy

Type plaatsingsbeleid voor knooppunten in Batch-pools. Toewijzingsbeleid dat door Batch Service wordt gebruikt om de knooppunten in te richten. Als dit niet is opgegeven, gebruikt Batch het regionale beleid.

geaccepteerde waarden: regional, zonal
--prioritize-unhealthy-instances

Werk alle beschadigde exemplaren in een schaalset bij voordat alle exemplaren in orde zijn. Waar als er een vlag aanwezig is.

geaccepteerde waarden: false, true
--resize-timeout

Deze time-out is alleen van toepassing op handmatig schalen; dit heeft geen effect wanneer enableAutoScale is ingesteld op true. De standaardwaarde is 15 minuten. De minimumwaarde is 5 minuten. Als u een waarde opgeeft die minder dan 5 minuten is, retourneert de Batch-service een fout; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag). Verwachte indeling is een ISO-8601-duur.

--resource-tags

De gebruiker kan resourcetags voor de pool opgeven. Alle resources die voor de pool zijn gemaakt, worden vervolgens ook gelabeld met dezelfde resourcetags.

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

Het terugdraaien van mislukte exemplaren naar het vorige model als het beleid voor rolling upgrades wordt geschonden. Waar als er een vlag aanwezig is.

geaccepteerde waarden: false, true
--security-type

Geef het SecurityType van de virtuele machine op. Deze moet worden ingesteld op een opgegeven waarde om Uefi Instellingen in te schakelen. Het standaardgedrag is: Uefi Instellingen wordt niet ingeschakeld, tenzij deze eigenschap is ingesteld.

--start-task-command-line

Vereist. De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies gebruik wilt maken, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Als de opdrachtregel verwijst naar bestandspaden, moet deze een relatief pad gebruiken (ten opzichte van de werkmap Taak) of de door Batch geleverde omgevingsvariabele (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--start-task-resource-files

Bestanden die onder dit element worden vermeld, bevinden zich in de werkmap van de taak. Door spaties gescheiden bronverwijzingen in bestandsnaam=httpurl-indeling.

--start-task-wait-for-success

Of de Batch-service moet wachten tot de StartTask is voltooid (dat wil gezegd: afsluiten met afsluitcode 0) voordat taken op het rekenknooppunt worden gepland. Indien waar en starttask mislukt op een knooppunt, probeert de Batch-service de StartTask opnieuw uit te voeren tot het maximumaantal nieuwe pogingen (maxTaskRetryCount). Als de taak na alle nieuwe pogingen nog steeds niet is voltooid, markeert de Batch-service het knooppunt onbruikbaar en plant deze niet. Deze voorwaarde kan worden gedetecteerd via de details van de status en foutgegevens van het rekenknooppunt. Als dit onwaar is, wacht de Batch-service niet tot de StartTask is voltooid. In dit geval kunnen andere taken worden uitgevoerd op het rekenknooppunt terwijl de StartTask nog steeds wordt uitgevoerd; en zelfs als de StartTask mislukt, worden nieuwe taken nog steeds gepland op het rekenknooppunt. De standaardwaarde is waar. Waar als er een vlag aanwezig is.

--storage-account-type

Het type opslagaccount voor beheerde schijf.

geaccepteerde waarden: premium_lrs, standard_lrs, standardssd_lrs
--target-communication

De gewenste communicatiemodus voor knooppunten voor de pool. Als dit element aanwezig is, vervangt dit de bestaande targetNodeCommunicationMode die is geconfigureerd voor de pool. Als u dit weglaat, blijven bestaande metagegevens ongewijzigd.

geaccepteerde waarden: classic, default, simplified
--target-dedicated-nodes

Het gewenste aantal toegewezen rekenknooppunten in de pool. Deze eigenschap mag niet worden opgegeven als enableAutoScale is ingesteld op true. Als enableAutoScale is ingesteld op false, moet u targetDedicatedNodes, targetLowPriorityNodes of beide instellen.

--target-low-priority-nodes

Het gewenste aantal spot-/lage prioriteit rekenknooppunten in de pool. Deze eigenschap mag niet worden opgegeven als enableAutoScale is ingesteld op true. Als enableAutoScale is ingesteld op false, moet u targetDedicatedNodes, targetLowPriorityNodes of beide instellen.

--targets

Als u dit weglaat, worden er geen schijven op de rekenknooppunten in de pool versleuteld. In linux-pool wordt alleen 'TemporaryDisk' ondersteund; in windows-pool moeten 'OsDisk' en 'TemporaryDisk' worden opgegeven. Ruimte gescheiden doelschijven die moeten worden versleuteld. Waarden kunnen OsDisk of TemporaryDisk zijn.

--task-slots-per-node

Het aantal taaksites dat kan worden gebruikt om gelijktijdige taken uit te voeren op één rekenknooppunt in de pool. De standaardwaarde is 1. De maximumwaarde is de kleinste van 4 keer het aantal kernen van de vmSize van de pool of 256.

--upgrade-policy-mode

De modus van de upgrade van het besturingssysteem van de pool.

geaccepteerde waarden: automatic, manual, rolling
--use-rolling-upgrade-policy

Hiermee wordt aangegeven of beleid voor rolling upgrades moet worden gebruikt tijdens de automatische upgrade van het besturingssysteem. Automatische upgrade van het besturingssysteem valt terug op het standaardbeleid als er geen beleid is gedefinieerd op de VMSS. Waar als er een vlag aanwezig is.

geaccepteerde waarden: false, true
--vm-size

Vereist. Zie Grootten voor Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/) voor informatie over de beschikbare grootten van virtuele machines voor Cloud Services-pools (pools die zijn gemaakt met cloudServiceConfiguration). Batch ondersteunt alle VM-grootten van Cloud Services, behalve ExtraSmall, A1V2 en A2V2. Zie Grootten voor virtuele machines (Linux)https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ of grootten voor virtuele machines (Windows)https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/ voor meer informatie over beschikbare VM-grootten voor pools met behulp van installatiekopieën van de Virtual Machines Marketplace (pools die zijn gemaakt met virtualMachineConfiguration). Batch ondersteunt alle azure-VM-grootten, behalve STANDARD_A0 en vm's met Premium Storage (STANDARD_GS, STANDARD_DS en STANDARD_DSV2 reeks).

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

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

Maak een Batch-pool in een account. Bij het maken van een pool kiest u argumenten uit Cloud Services-configuratie of configuratie van virtuele machines.

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]

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

De Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

De naam van het Batch-account. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--application-licenses

De lijst met toepassingslicenties moet een subset van beschikbare Licenties voor Batch-servicetoepassingen zijn. Als er een licentie wordt aangevraagd die niet wordt ondersteund, mislukt het maken van een pool.

--application-package-references

Bij het maken van een pool moet de toepassings-id van het pakket volledig zijn gekwalificeerd (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Wijzigingen in pakketverwijzingen zijn van invloed op alle nieuwe knooppunten die lid zijn van de pool, maar hebben geen invloed op rekenknooppunten die zich al in de pool bevinden totdat ze opnieuw worden opgestart of opnieuw worden hersteld. Er zijn maximaal 10 pakketverwijzingen voor een bepaalde groep.

--auto-scale-formula

Deze eigenschap mag niet worden opgegeven als enableAutoScale is ingesteld op false. Dit is vereist als enableAutoScale is ingesteld op true. De formule wordt gecontroleerd op geldigheid voordat de pool wordt gemaakt. Als de formule niet geldig is, weigert de Batch-service de aanvraag met gedetailleerde foutinformatie. Zie 'Rekenknooppunten automatisch schalen in een Azure Batch-pool' (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/) voor meer informatie over het opgeven van deze formule.

--certificate-references

Voor Windows-knooppunten installeert de Batch-service de certificaten op het opgegeven certificaatarchief en de opgegeven locatie. Voor Linux-rekenknooppunten worden de certificaten opgeslagen in een map in de werkmap Taak en wordt een omgevingsvariabele AZ_BATCH_CERTIFICATES_DIR aan de taak verstrekt om een query uit te voeren op deze locatie. Voor certificaten met zichtbaarheid van remoteUser wordt een map met certificaten gemaakt in de basismap van de gebruiker (bijvoorbeeld /home/{user-name}/certs) en certificaten worden in die map geplaatst. Waarschuwing: deze eigenschap is afgeschaft en wordt na februari 2024 verwijderd. Gebruik in plaats daarvan de Azure KeyVault-extensie .

--disk-encryption-targets

Een spatie gescheiden lijst met DiskEncryptionTargets. huidige mogelijke waarden zijn OsDisk en TemporaryDisk.

--enable-inter-node-communication

Of de pool directe communicatie tussen rekenknooppunten toestaat. Als u communicatie tussen knooppunten inschakelt, wordt de maximale grootte van de pool beperkt vanwege implementatiebeperkingen op de rekenknooppunten van de pool. Dit kan ertoe leiden dat de pool de gewenste grootte niet bereikt. De standaardwaarde is false.

standaardwaarde: False
--id

Vereist. De id kan elke combinatie van alfanumerieke tekens bevatten, inclusief afbreekstreepjes en onderstrepingstekens, en mag niet meer dan 64 tekens bevatten. De id is hoofdlettergevoelig en niet hoofdlettergevoelig (dat wil gezegd, u hebt mogelijk geen twee pool-id's binnen een account die alleen per geval verschillen).

--image

Naslaginformatie over installatiekopieën van het besturingssysteem. Dit kan de indeling publisher:offer:sku[:version], of een volledig gekwalificeerde ARM-installatiekopieën-id zijn van het formulier /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}. Als de indeling publisher:offer:sku[:version], is de versie optioneel en wordt de meest recente weggelaten gebruikt. Geldige waarden kunnen worden opgehaald via 'az batch pool node-agent-skus list'. Bijvoorbeeld: 'MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest'.

--json-file

Het bestand met de pool dat moet worden gemaakt in JSON-indeling, als deze parameter is opgegeven, worden alle andere parameters genegeerd.

--metadata

De Batch-service wijst geen betekenis toe aan metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode.

--node-agent-sku-id

De SKU van de Batch-knooppuntagent die moet worden ingericht op rekenknooppunten in de pool. De Batch-knooppuntagent is een programma dat wordt uitgevoerd op elk knooppunt in de pool en biedt de interface voor opdracht en beheer tussen het knooppunt en de Batch-service. Er zijn verschillende implementaties van de knooppuntagent, ook wel SKU's genoemd, voor verschillende besturingssystemen. U moet een knooppuntagent-SKU opgeven die overeenkomt met de geselecteerde afbeeldingsreferentie. Zie de bewerking Ondersteunde agent-SKU's voor ondersteunde knooppunten, samen met de lijst met geverifieerde afbeeldingsverwijzingen, de bewerking Ondersteunde knooppuntagent-SKU's weergeven.

--os-family

De Azure Guest OS-familie die moet worden geïnstalleerd op de virtuele machines in de pool. Mogelijke waarden zijn: 2 - OS Family 2, gelijk aan Windows Server 2008 R2 SP1. 3 - OS Family 3, gelijk aan Windows Server 2012. 4 - OS Family 4, gelijk aan Windows Server 2012 R2. 5 - OS Family 5, gelijk aan Windows Server 2016. Zie Releases van gastbesturingssystemen van Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases) voor meer informatie. Toegestane waarden: 2, 3, 4, 5.

--os-version

De standaardwaarde is * waarmee de meest recente versie van het besturingssysteem voor de opgegeven besturingssysteemfamilie wordt opgegeven.

--parameters

Parameterwaarden voor een JSON-sjabloonbestand voor een Batch-pool. Kan alleen worden gebruikt met --template.

--policy

Type plaatsingsbeleid voor knooppunten in Batch-pools. Toewijzingsbeleid dat door Batch Service wordt gebruikt om de knooppunten in te richten. Als dit niet is opgegeven, gebruikt Batch het regionale beleid. Toegestane waarden: regionaal, zonegebonden.

--resize-timeout

Deze time-out is alleen van toepassing op handmatig schalen; dit heeft geen effect wanneer enableAutoScale is ingesteld op true. De standaardwaarde is 15 minuten. De minimumwaarde is 5 minuten. Als u een waarde opgeeft die minder dan 5 minuten is, retourneert de Batch-service een fout; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag).

--resource-group

De resourcegroep van het Batch-account.

--start-task-command-line

De opdrachtregel van de begintaak. De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies gebruik wilt maken, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux.

--start-task-resource-files

Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert. Door ruimte gescheiden bronverwijzingen in bestandsnaam=httpurl-indeling.

--start-task-wait-for-success

Of de Batch-service moet wachten totdat de begintaak is voltooid (dat wil gezegd, om af te sluiten met afsluitcode 0) voordat u taken op het rekenknooppunt plant. Als waar is en de begintaak mislukt op een rekenknooppunt, probeert de Batch-service de opstarttaak opnieuw uit te voeren tot het maximumaantal nieuwe pogingen (maxTaskRetryCount). Als de taak na alle nieuwe pogingen nog steeds niet is voltooid, markeert de Batch-service het rekenknooppunt onbruikbaar en worden er geen taken naar gepland. Deze voorwaarde kan worden gedetecteerd via de knooppuntstatus en planningsfoutdetails. Als dit onwaar is, wacht de Batch-service niet totdat de begintaak is voltooid. In dit geval kunnen andere taken worden uitgevoerd op het rekenknooppunt terwijl de begintaak nog steeds wordt uitgevoerd; en zelfs als de begintaak mislukt, blijven nieuwe taken gepland op het knooppunt. De standaardwaarde is onwaar. Waar als er een vlag aanwezig is.

standaardwaarde: False
--target-dedicated-nodes

Het gewenste aantal toegewezen rekenknooppunten in de pool. Deze eigenschap mag niet worden opgegeven als enableAutoScale is ingesteld op true. Als enableAutoScale is ingesteld op false, moet u targetDedicatedNodes, targetLowPriorityNodes of beide instellen.

--target-low-priority-nodes

Het gewenste aantal spot-/lage prioriteit rekenknooppunten in de pool. Deze eigenschap mag niet worden opgegeven als enableAutoScale is ingesteld op true. Als enableAutoScale is ingesteld op false, moet u targetDedicatedNodes, targetLowPriorityNodes of beide instellen.

--targets

Als u dit weglaat, worden er geen schijven op de rekenknooppunten in de pool versleuteld. In linux-pool wordt alleen 'TemporaryDisk' ondersteund; in windows-pool moeten 'OsDisk' en 'TemporaryDisk' worden opgegeven. Ruimte gescheiden doelschijven die moeten worden versleuteld. Waarden kunnen OsDisk of TemporaryDisk zijn.

--task-slots-per-node

Het aantal taaksites dat kan worden gebruikt om gelijktijdige taken uit te voeren op één rekenknooppunt in de pool. De standaardwaarde is 1. De maximumwaarde is de kleinste van 4 keer het aantal kernen van de vmSize van de pool of 256.

--template

Een JSON-sjabloonbestand voor een Batch-pool. Als deze parameter is opgegeven, worden alle andere parameters genegeerd.

--vm-size

Vereist. Zie Grootten voor Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/) voor informatie over de beschikbare grootten van virtuele machines voor Cloud Services-pools (pools die zijn gemaakt met cloudServiceConfiguration). Batch ondersteunt alle VM-grootten van Cloud Services, behalve ExtraSmall, A1V2 en A2V2. Zie Grootten voor virtuele machines (Linux)https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ of grootten voor virtuele machines (Windows)https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/ voor meer informatie over beschikbare VM-grootten voor pools met behulp van installatiekopieën van de Virtual Machines Marketplace (pools die zijn gemaakt met virtualMachineConfiguration). Batch ondersteunt alle azure-VM-grootten, behalve STANDARD_A0 en vm's met Premium Storage (STANDARD_GS, STANDARD_DS en STANDARD_DSV2 reeks).

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batch pool delete

Hiermee verwijdert u een pool uit het opgegeven account.

Wanneer u aanvraagt dat een pool wordt verwijderd, vinden de volgende acties plaats: de poolstatus is ingesteld op verwijderen; eventuele lopende groottebewerkingen in de pool worden gestopt; de Batch-service begint de grootte van de pool te wijzigen in nul rekenknooppunten; alle taken die op bestaande rekenknooppunten worden uitgevoerd, worden beëindigd en opnieuw in de wachtrij gezet (alsof een bewerking voor het wijzigen van de grootte van de pool is aangevraagd met de standaardoptie voor opnieuw weergeven); ten slotte wordt de pool uit het systeem verwijderd. Omdat taken opnieuw worden uitgevoerd, kan de gebruiker deze taken opnieuw uitvoeren door de taak bij te werken om een andere pool te bereiken. De taken kunnen vervolgens worden uitgevoerd op de nieuwe pool. Als u het requeuegedrag wilt overschrijven, moet u het formaat van de pool expliciet aanroepen om de pool te verkleinen tot nul voordat u de pool verwijdert. Als u een Update-, Patch- of Delete-API aanroept in een pool met de status Verwijderen, mislukt deze met HTTP-statuscode 409 met foutcode 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]

Vereiste parameters

--pool-id

De id van de groep die u wilt verwijderen.

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--if-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service exact overeenkomt met de waarde die is opgegeven door de client.

--if-modified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--if-none-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service niet overeenkomt met de waarde die is opgegeven door de client.

--if-unmodified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service niet is gewijzigd sinds de opgegeven tijd.

--yes -y

Niet vragen om bevestiging.

standaardwaarde: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batch pool list

Een lijst met alle pools in het opgegeven account.

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

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--expand

Een OData-$expand-component.

--filter

Een OData-$filter-component. Zie voor meer informatie over het maken van dit filter https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-pools.

--select

Een OData-$select-component.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batch pool reset

Werk de eigenschappen van een Batch-pool bij. Niet-opgegeven eigenschappen die kunnen worden bijgewerkt, worden teruggezet naar de standaardwaarden.

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]

Vereiste parameters

--pool-id

De id van de pool die moet worden bijgewerkt.

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

De Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

De naam van het Batch-account. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--application-package-references

Vereist. De lijst vervangt alle bestaande verwijzingen naar toepassingspakketten in de groep. Wijzigingen in toepassingspakketverwijzingen zijn van invloed op alle nieuwe rekenknooppunten die lid zijn van de pool, maar hebben geen invloed op rekenknooppunten die al in de pool staan totdat ze opnieuw worden opgestart of opnieuw worden gemaakt. Er zijn maximaal 10 toepassingspakketverwijzingen voor een bepaalde groep. Als u dit weglaat of als u een lege verzameling opgeeft, worden bestaande verwijzingen naar toepassingspakketten uit de groep verwijderd. Er kunnen maximaal 10 verwijzingen worden opgegeven voor een bepaalde groep.

--certificate-references

Vereist. Deze lijst vervangt alle bestaande certificaatverwijzingen die zijn geconfigureerd voor de groep. Als u een lege verzameling opgeeft, worden alle bestaande certificaatverwijzingen uit de groep verwijderd. Voor Windows-knooppunten installeert de Batch-service de certificaten op het opgegeven certificaatarchief en de opgegeven locatie. Voor Linux-rekenknooppunten worden de certificaten opgeslagen in een map in de werkmap Taak en wordt een omgevingsvariabele AZ_BATCH_CERTIFICATES_DIR aan de taak verstrekt om een query uit te voeren op deze locatie. Voor certificaten met zichtbaarheid van remoteUser wordt een map met certificaten gemaakt in de basismap van de gebruiker (bijvoorbeeld /home/{user-name}/certs) en certificaten worden in die map geplaatst. Waarschuwing: deze eigenschap is afgeschaft en wordt na februari 2024 verwijderd. Gebruik in plaats daarvan de Azure KeyVault-extensie .

--json-file

Het bestand met de parameterspecificatie van de eigenschappen van de pool bijwerken in JSON (opgemaakt om overeen te komen met de hoofdtekst van de REST API-aanvraag). Als deze parameter is opgegeven, worden alle parameterargumenten voor poolupdate-eigenschappen genegeerd.

--metadata

Vereist. Deze lijst vervangt alle bestaande metagegevens die zijn geconfigureerd voor de pool. Als u dit weglaat of als u een lege verzameling opgeeft, worden bestaande metagegevens uit de pool verwijderd.

--start-task-command-line

De opdrachtregel van de begintaak. De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies gebruik wilt maken, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux.

--start-task-environment-settings

Een lijst met omgevingsvariabeleinstellingen voor de begintaak. Door spaties gescheiden waarden in de notatie 'key=value'.

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

Het maximum aantal keren dat de taak opnieuw kan worden geprobeerd.

--start-task-wait-for-success

Of de Batch-service moet wachten totdat de begintaak is voltooid (dat wil gezegd, om af te sluiten met afsluitcode 0) voordat u taken op het rekenknooppunt plant. Waar als de vlag aanwezig is, wordt anders standaard ingesteld op Onwaar.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batch pool resize

Wijzig het formaat of stop het formaat van een Batch-pool.

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]

Vereiste parameters

--pool-id

De id van de pool.

Optionele parameters

--abort

Stop de grootte van de pool.

standaardwaarde: False
--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

De Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

De naam van het Batch-account. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--if-match

De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource exact overeenkomt met de opgegeven waarde.

--if-modified-since

De bewerking wordt alleen uitgevoerd als de resource is gewijzigd sinds de opgegeven tijdstempel.

--if-none-match

De bewerking wordt niet alleen uitgevoerd als de huidige ETag van de resource exact overeenkomt met de opgegeven waarde.

--if-unmodified-since

De bewerking wordt niet alleen uitgevoerd als de resource is gewijzigd sinds de opgegeven tijdstempel.

--node-deallocation-option

Wanneer knooppunten uit de pool kunnen worden verwijderd, als de poolgrootte afneemt.

geaccepteerde waarden: requeue, retaineddata, taskcompletion, terminate
--resize-timeout

De standaardwaarde is 15 minuten. De minimumwaarde is 5 minuten. Als u een waarde opgeeft die minder dan 5 minuten is, retourneert de Batch-service een fout; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag).

--target-dedicated-nodes

Het gewenste aantal toegewezen rekenknooppunten in de pool.

--target-low-priority-nodes

Het gewenste aantal spot-/lage prioriteit rekenknooppunten in de pool.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batch pool set

Werk de eigenschappen van een Batch-pool bij. Als u een eigenschap in een subgroep bijwerkt, worden de niet-opgegeven eigenschappen van die groep opnieuw ingesteld.

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}]

Vereiste parameters

--pool-id

De id van de pool die moet worden bijgewerkt.

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--application-package-references

Wijzigingen in pakketverwijzingen zijn van invloed op alle nieuwe knooppunten die lid zijn van de pool, maar hebben geen invloed op rekenknooppunten die zich al in de pool bevinden totdat ze opnieuw worden opgestart of opnieuw worden hersteld. Als dit element aanwezig is, worden alle bestaande pakketverwijzingen vervangen. Als u een lege verzameling opgeeft, worden alle pakketverwijzingen uit de pool verwijderd. Als u dit weglaat, blijven bestaande pakketverwijzingen ongewijzigd. Toepassings-id's met optionele versie met de indeling id[#version].

--certificate-references

Als dit element aanwezig is, vervangt dit alle bestaande certificaatverwijzingen die zijn geconfigureerd voor de groep. Als u dit weglaat, blijven bestaande certificaatverwijzingen ongewijzigd. Voor Windows-knooppunten installeert de Batch-service de certificaten op het opgegeven certificaatarchief en de opgegeven locatie. Voor Linux-rekenknooppunten worden de certificaten opgeslagen in een map in de werkmap Taak en wordt een omgevingsvariabele AZ_BATCH_CERTIFICATES_DIR aan de taak verstrekt om een query uit te voeren op deze locatie. Voor certificaten met zichtbaarheid van remoteUser wordt een map met certificaten gemaakt in de basismap van de gebruiker (bijvoorbeeld /home/{user-name}/certs) en certificaten worden in die map geplaatst. Waarschuwing: deze eigenschap is afgeschaft en wordt na februari 2024 verwijderd. Gebruik in plaats daarvan de Azure KeyVault-extensie . Vingerafdruk van door spaties gescheiden certificaten.

--if-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service exact overeenkomt met de waarde die is opgegeven door de client.

--if-modified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--if-none-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service niet overeenkomt met de waarde die is opgegeven door de client.

--if-unmodified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service niet is gewijzigd sinds de opgegeven tijd.

--json-file

Een bestand met de parameterspecificatie van de poolpatch in JSON (opgemaakt zodat deze overeenkomt met de respectieve REST API-hoofdtekst). Als deze parameter is opgegeven, worden alle 'Poolargumenten' genegeerd.

--metadata

Als dit element aanwezig is, vervangt dit alle bestaande metagegevens die in de pool zijn geconfigureerd. Als u een lege verzameling opgeeft, worden alle metagegevens uit de pool verwijderd. Als u dit weglaat, blijven bestaande metagegevens ongewijzigd. Door spaties gescheiden waarden in de notatie 'key=value'.

--start-task-command-line

Vereist. De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies gebruik wilt maken, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Als de opdrachtregel verwijst naar bestandspaden, moet deze een relatief pad gebruiken (ten opzichte van de werkmap Taak) of de door Batch geleverde omgevingsvariabele (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--start-task-environment-settings

Door spaties gescheiden waarden in de notatie 'key=value'.

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

Het maximum aantal keren dat de taak opnieuw kan worden geprobeerd. De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode niet-nul is. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De Batch-service probeert de taak eenmaal uit en probeert vervolgens opnieuw tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch de taak maximaal 4 keer (één eerste poging en drie nieuwe pogingen). Als het maximumaantal nieuwe pogingen 0 is, voert de Batch-service de taak niet opnieuw uit. Als het maximumaantal nieuwe pogingen -1 is, probeert de Batch-service de taak opnieuw zonder limiet, maar dit wordt niet aanbevolen voor een begintaak of een andere taak. De standaardwaarde is 0 (geen nieuwe pogingen).

--start-task-resource-files

Bestanden die onder dit element worden vermeld, bevinden zich in de werkmap van de taak. Door spaties gescheiden bronverwijzingen in bestandsnaam=httpurl-indeling.

--start-task-wait-for-success

Of de Batch-service moet wachten tot de StartTask is voltooid (dat wil gezegd: afsluiten met afsluitcode 0) voordat taken op het rekenknooppunt worden gepland. Indien waar en starttask mislukt op een knooppunt, probeert de Batch-service de StartTask opnieuw uit te voeren tot het maximumaantal nieuwe pogingen (maxTaskRetryCount). Als de taak na alle nieuwe pogingen nog steeds niet is voltooid, markeert de Batch-service het knooppunt onbruikbaar en plant deze niet. Deze voorwaarde kan worden gedetecteerd via de details van de status en foutgegevens van het rekenknooppunt. Als dit onwaar is, wacht de Batch-service niet tot de StartTask is voltooid. In dit geval kunnen andere taken worden uitgevoerd op het rekenknooppunt terwijl de StartTask nog steeds wordt uitgevoerd; en zelfs als de StartTask mislukt, worden nieuwe taken nog steeds gepland op het rekenknooppunt. De standaardwaarde is waar. Geef 'true' of 'false' op om de eigenschap bij te werken.

--target-communication

De gewenste communicatiemodus voor knooppunten voor de pool. Als dit element aanwezig is, vervangt dit de bestaande targetNodeCommunicationMode die is geconfigureerd voor de pool. Als u dit weglaat, blijven bestaande metagegevens ongewijzigd.

geaccepteerde waarden: classic, default, simplified
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batch pool show

Hiermee wordt informatie opgehaald over de opgegeven pool.

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]

Vereiste parameters

--pool-id

De id van de pool die u wilt ophalen.

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--expand

Een OData-$expand-component.

--if-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service exact overeenkomt met de waarde die is opgegeven door de client.

--if-modified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--if-none-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service niet overeenkomt met de waarde die is opgegeven door de client.

--if-unmodified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service niet is gewijzigd sinds de opgegeven tijd.

--select

Een OData-$select-component.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.