az batch pool

Kommentar

Den här kommandogruppen har kommandon som definieras i både Azure CLI och minst ett tillägg. Installera varje tillägg för att dra nytta av dess utökade funktioner. Läs mer om tillägg.

Hantera Batch-pooler.

Kommandon

Name Description Typ Status
az batch pool autoscale

Hantera automatisk skalning av Batch-pooler.

Kärna Allmän tillgänglighet
az batch pool autoscale disable

Inaktiverar automatisk skalning för en pool.

Kärna Allmän tillgänglighet
az batch pool autoscale enable

Aktiverar automatisk skalning för en pool.

Kärna Allmän tillgänglighet
az batch pool autoscale evaluate

Hämtar resultatet av utvärderingen av en automatisk skalningsformel i poolen.

Kärna Allmän tillgänglighet
az batch pool create

Skapa en Batch-pool i ett konto. När du skapar en pool väljer du argument från antingen Cloud Services Configuration eller Virtual Machine Configuration.

Kärna Allmän tillgänglighet
az batch pool create (azure-batch-cli-extensions anknytning)

Skapa en Batch-pool i ett konto. När du skapar en pool väljer du argument från antingen Cloud Services Configuration eller Virtual Machine Configuration.

Anknytning Allmän tillgänglighet
az batch pool delete

Tar bort en pool från det angivna kontot.

Kärna Allmän tillgänglighet
az batch pool list

Visar en lista över alla pooler i det angivna kontot.

Kärna Allmän tillgänglighet
az batch pool node-counts

Hämta nodantal för Batch-pooler.

Kärna Allmän tillgänglighet
az batch pool node-counts list

Hämtar antalet beräkningsnoder i varje tillstånd, grupperat efter pool.

Kärna Allmän tillgänglighet
az batch pool reset

Uppdatera egenskaperna för en Batch-pool. Ospecificerade egenskaper som kan uppdateras återställs till standardinställningarna.

Kärna Allmän tillgänglighet
az batch pool resize

Ändra storlek på eller sluta ändra storlek på en Batch-pool.

Kärna Allmän tillgänglighet
az batch pool set

Uppdatera egenskaperna för en Batch-pool. Om du uppdaterar en egenskap i en undergrupp återställs de ospecificerade egenskaperna för gruppen.

Kärna Allmän tillgänglighet
az batch pool show

Hämtar information om den angivna poolen.

Kärna Allmän tillgänglighet
az batch pool supported-images

Fråga efter information om VM-avbildningar som stöds av Azure Batch-tjänsten.

Kärna Allmän tillgänglighet
az batch pool supported-images list

Visar en lista över alla avbildningar av virtuella datorer som stöds av Azure Batch-tjänsten.

Kärna Allmän tillgänglighet
az batch pool usage-metrics

Visa användningsstatistik för Batch-pooler.

Kärna Allmän tillgänglighet
az batch pool usage-metrics list

Visar en lista över användningsstatistik, aggregerade efter pool över enskilda tidsintervall, för det angivna kontot.

Kärna Allmän tillgänglighet

az batch pool create

Skapa en Batch-pool i ett konto. När du skapar en pool väljer du argument från antingen Cloud Services Configuration eller Virtual Machine Configuration.

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]

Valfria parametrar

--accelerated-networking

Om den här poolen ska aktivera accelererat nätverk. Accelererat nätverk möjliggör enkel rot-I/O-virtualisering (SR-IOV) till en virtuell dator, vilket kan leda till bättre nätverksprestanda. Mer information finns i: https://learn.microsoft.com/azure/virtual- network/accelerated-networking-overview. Ange true för att aktivera.

accepterade värden: false, true
--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--application-licenses

Listan över programlicenser måste vara en delmängd av tillgängliga Batch-tjänstprogramlicenser. Om en licens begärs som inte stöds misslyckas skapande av pool. Blankstegsavgränsade värden.

--application-package-references

När du skapar en pool måste paketets program-ID vara fullständigt kvalificerat (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Ändringar i paketreferenser påverkar alla nya noder som ansluter till poolen, men påverkar inte beräkningsnoder som redan finns i poolen förrän de startas om eller omskapas. Det finns högst 10 paketreferenser för en viss pool. Utrymmesavgränsade program-ID:er med valfri version i formatet "id[#version]".

--auto-scale-formula

En formel för önskat antal beräkningsnoder i poolen. Formeln kontrolleras för giltighet innan poolen skapas. Om formeln inte är giltig avvisar Batch-tjänsten begäran med detaljerad felinformation. Mer information om hur du anger den här formeln finns i https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/.

--certificate-references

För Windows-noder installerar Batch-tjänsten certifikaten till det angivna certifikatarkivet och platsen. För Linux-beräkningsnoder lagras certifikaten i en katalog i arbetskatalogen Aktivitet och en miljövariabel AZ_BATCH_CERTIFICATES_DIR skickas till uppgiften för att fråga efter den här platsen. För certifikat med synlighet för "remoteUser" skapas en "certifikatkatalog" i användarens hemkatalog (t.ex. /home/{user-name}/certs) och Certifikat placeras i den katalogen. Varning! Den här egenskapen är inaktuell och tas bort efter februari 2024. Använd Azure KeyVault-tillägget i stället. Tumavtryck för blankstegsavgränsade certifikat.

--defer-os-rolling-upgrade

Skjut upp OS-uppgraderingar på TV-datorerna om de kör uppgifter. Sant om flaggan finns.

accepterade värden: false, true
--disable-auto-rollback

Om funktionen för återställning av os-avbildning ska inaktiveras. Sant om flaggan finns.

accepterade värden: false, true
--disk-encryption-targets

En blankstegsavgränsad lista över DiskEncryptionTargets. aktuella möjliga värden är OsDisk och TemporaryDisk.

--enable-auto-os-upgrade

Anger om OS-uppgraderingar automatiskt ska tillämpas på skalningsuppsättningsinstanser på ett löpande sätt när en nyare version av OS-avbildningen blir tillgänglig.

Om detta är inställt på sant för Windows-baserade pooler kan WindowsConfiguration.enableAutomatic Uppdateringar inte anges till sant. Sant om flaggan finns.

accepterade värden: false, true
--enable-cross-zone-upgrade

Tillåt ATT VMSS ignorerar AZ-gränser när du skapar uppgraderingsbatch. Ta hänsyn till uppdateringsdomänen och maxBatchInstancePercent för att fastställa batchstorleken. Det här fältet kan endast anges till sant eller falskt när nodePlacementConfiguration används som zonindelning. Sant om flaggan finns.

accepterade värden: false, true
--enable-inter-node-communication

Om poolen tillåter direkt kommunikation mellan beräkningsnoder. Om kommunikation mellan noder aktiveras begränsas poolens maximala storlek på grund av distributionsbegränsningar för poolens beräkningsnoder. Detta kan leda till att poolen inte når önskad storlek. Standardvärdet är "false". Sant om flaggan finns.

--enable-secure-boot

Aktivera säker start.

accepterade värden: false, true
--enable-vtpm

Aktivera vTPM.

accepterade värden: false, true
--enable-write-accel

Ange om writeAccelerator ska aktiveras eller inaktiveras på disken.

accepterade värden: false, true
--encryption-at-host

Den här egenskapen kan användas av användaren i begäran för att aktivera eller inaktivera värdkryptering för den virtuella datorn eller vm-skalningsuppsättningen. Detta aktiverar krypteringen för alla diskar, inklusive resurs/temp-disk på själva värden. Standardbeteendet är: Krypteringen på värden inaktiveras om inte den här egenskapen är inställd på true för resursen.

accepterade värden: false, true
--id

Obligatoriskt. ID:t kan innehålla valfri kombination av alfanumeriska tecken, inklusive bindestreck och understreck, och får inte innehålla fler än 64 tecken. ID:t är skiftlägesbevarande och skiftlägesokänsligt (dvs. du kanske inte har två pool-ID:n inom ett konto som endast skiljer sig åt från fall till fall).

--image

Referens för OS-avbildning. Detta kan vara formatet "publisher:offer:sku[:version]" eller ett fullständigt kvalificerat ARM-avbildnings-ID för formuläret '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}'. Om formatet "publisher:offer:sku[:version]" är versionen valfri och om den senaste versionen utelämnas används den. Giltiga värden kan hämtas via "az batch pool supported-images list". Exempel: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".

--json-file

Filen som innehåller parameterspecifikationen för poolskapandeegenskaper i JSON (formaterad för att matcha REST API-begärandetexten). Om den här parametern anges ignoreras alla "Parameterargument för poolskapa egenskaper". Se https://docs.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#request-body.

--max-batch-instance-percent

Den maximala procentandelen av de totala virtuella datorinstanserna som uppgraderas samtidigt av den löpande uppgraderingen i en batch. Eftersom detta är ett maximalt antal felaktiga instanser i tidigare eller framtida batchar kan procentandelen instanser i en batch minska för att säkerställa högre tillförlitlighet. Värdet för det här fältet ska vara mellan 5 och 100, inklusive. Om både maxBatchInstancePercent och maxUnhealthyInstancePercent tilldelas med värde bör värdet för maxBatchInstancePercent inte vara mer än maxUnhealthyInstancePercent.

--max-unhealthy-instance-percent

Den maximala procentandelen av de totala virtuella datorinstanserna i skalningsuppsättningen som kan vara felfritt samtidigt, antingen till följd av uppgraderingen eller genom att hittas i ett feltillstånd av hälsokontrollerna för den virtuella datorn innan den löpande uppgraderingen avbryts. Den här begränsningen kontrolleras innan någon batch startas. Värdet för det här fältet ska vara mellan 5 och 100, inklusive. Om både maxBatchInstancePercent och maxUnhealthyInstancePercent tilldelas med värde bör värdet för maxBatchInstancePercent inte vara mer än maxUnhealthyInstancePercent.

--max-unhealthy-upgraded-instance-percent

Den maximala procentandelen uppgraderade virtuella datorinstanser som kan konstateras vara i ett feltillstånd. Den här kontrollen sker när varje batch har uppgraderats. Om den här procentandelen någonsin överskrids avbryts den löpande uppdateringen. Värdet för det här fältet ska vara mellan 0 och 100, inklusive.

--metadata

Batch-tjänsten tilldelar ingen betydelse för metadata. det är endast för användning av användarkod. Blankstegsavgränsade värden i formatet "key=value".

--node-agent-sku-id

Obligatoriskt. Batch Compute Node-agenten är ett program som körs på varje beräkningsnod i poolen och tillhandahåller kommando- och kontrollgränssnittet mellan beräkningsnoden och Batch-tjänsten. Det finns olika implementeringar av Compute Node-agenten, som kallas SKU:er, för olika operativsystem. Du måste ange en SKU för Beräkningsnodagent som matchar den valda avbildningsreferensen. Information om hur du hämtar listan över beräkningsnodagent-SKU:er som stöds tillsammans med deras lista över verifierade bildreferenser finns i åtgärden "List supported Compute Node agent SKU:er".

--os-disk-caching

Ange cachelagringskraven. Möjliga värden är: None, ReadOnly, ReadWrite. Standardvärdena är: Ingen för standardlagring. ReadOnly för Premium Storage.

accepterade värden: none, readonly, readwrite
--os-disk-size

Den ursprungliga diskstorleken i GB när du skapar en ny OS-disk.

--os-family

Obligatoriskt. Möjliga värden är: 2 – OS Family 2, motsvarande Windows Server 2008 R2 SP1. 3 – OS Family 3, motsvarande Windows Server 2012. 4 – OS Family 4, motsvarande Windows Server 2012 R2. 5 – OS Family 5, motsvarande Windows Server 2016. 6 – OS Family 6, motsvarande Windows Server 2019. Mer information finns i Azure Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).

accepterade värden: 2, 3, 4, 5, 6
--os-version

Standardvärdet är * som anger den senaste operativsystemversionen för den angivna operativsystemfamiljen.

--pause-time-between-batches

Väntetiden mellan att slutföra uppdateringen för alla virtuella datorer i en batch och starta nästa batch. Varaktigheten ska anges i ISO 8601-format. Förväntat format är en ISO-8601-varaktighet.

--placement

Anger den tillfälliga diskplaceringen för operativsystemdisken för alla virtuella datorer i poolen. Den här egenskapen kan användas av användaren i begäran om att välja plats, t.ex. cachelagring av diskutrymme för tillfällig OS-disketablering. Mer information om krav på tillfällig OS-diskstorlek finns i Krav på tillfällig OS-diskstorlek för virtuella Windows-datorer på https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements och virtuella Linux-datorer på https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

accepterade värden: cachedisk
--policy

Principtyp för nodplacering i Batch-pooler. Allokeringsprincip som används av Batch Service för att etablera noderna. Om det inte anges använder Batch regionalprincipen.

accepterade värden: regional, zonal
--prioritize-unhealthy-instances

Uppgradera alla instanser med feltillstånd i en skalningsuppsättning före eventuella felfria instanser. Sant om flaggan finns.

accepterade värden: false, true
--resize-timeout

Den här tidsgränsen gäller endast för manuell skalning. det har ingen effekt när enableAutoScale är inställt på sant. Standardvärdet är 15 minuter. Minimivärdet är 5 minuter. Om du anger ett värde som är mindre än 5 minuter returnerar Batch-tjänsten ett fel. Om du anropar REST-API:et direkt är HTTP-statuskoden 400 (felaktig begäran). Förväntat format är en ISO-8601-varaktighet.

--resource-tags

Användaren kan ange resurstaggar för poolen. Alla resurser som skapas för poolen kommer sedan också att taggas av samma resurstaggar.

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

Återställningen misslyckades för instanser till en tidigare modell om principen för löpande uppgradering överträds. Sant om flaggan finns.

accepterade värden: false, true
--security-type

Ange SecurityType för den virtuella datorn. Det måste anges till ett angivet värde för att aktivera Uefi Inställningar. Standardbeteendet är: Uefi Inställningar aktiveras inte om inte den här egenskapen har angetts.

--start-task-command-line

Obligatoriskt. Kommandoraden körs inte under ett gränssnitt och kan därför inte dra nytta av gränssnittsfunktioner som miljövariabelexpansion. Om du vill dra nytta av sådana funktioner bör du anropa gränssnittet på kommandoraden, till exempel med hjälp av "cmd /c MyCommand" i Windows eller "/bin/sh -c MyCommand" i Linux. Om kommandoraden refererar till filsökvägar bör den använda en relativ sökväg (i förhållande till arbetskatalogen Uppgift) eller använda miljövariabeln Batch som tillhandahålls (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--start-task-resource-files

Filer som visas under det här elementet finns i arbetskatalogen för aktiviteten. Utrymmesavgränsade resursreferenser i filnamn=httpurl-format.

--start-task-wait-for-success

Om Batch-tjänsten ska vänta tills StartTask har slutförts (d.v.s. avsluta med slutkod 0) innan du schemalägger aktiviteter på beräkningsnoden. Om true och StartTask misslyckas på en nod, försöker Batch-tjänsten starta om StartTask upp till det maximala antalet återförsök (maxTaskRetryCount). Om aktiviteten fortfarande inte har slutförts efter alla återförsök markerar Batch-tjänsten noden oanvändbar och schemalägger inte Aktiviteter till den. Det här villkoret kan identifieras via beräkningsnodens tillstånd och information om felinformation. Om det är falskt väntar inte Batch-tjänsten på att StartTask ska slutföras. I det här fallet kan andra uppgifter börja köras på beräkningsnoden medan StartTask fortfarande körs. och även om StartTask misslyckas fortsätter nya aktiviteter att schemaläggas på beräkningsnoden. Standardvärdet är sant. Sant om flaggan finns.

--storage-account-type

Lagringskontotypen för hanterad disk.

accepterade värden: premium_lrs, standard_lrs, standardssd_lrs
--target-communication

Önskat nodkommunikationsläge för poolen. Om det här elementet finns ersätter det befintliga targetNodeCommunicationMode som konfigurerats i poolen. Om de utelämnas lämnas alla befintliga metadata oförändrade.

accepterade värden: classic, default, simplified
--target-dedicated-nodes

Önskat antal dedikerade beräkningsnoder i poolen. Den här egenskapen får inte anges om enableAutoScale är inställt på true. Om enableAutoScale är inställt på false måste du ange antingen targetDedicatedNodes, targetLowPriorityNodes eller båda.

--target-low-priority-nodes

Önskat antal beräkningsnoder med oanvänd kapacitet/låg prioritet i poolen. Den här egenskapen får inte anges om enableAutoScale är inställt på true. Om enableAutoScale är inställt på false måste du ange antingen targetDedicatedNodes, targetLowPriorityNodes eller båda.

--targets

Om det utelämnas krypteras inga diskar på beräkningsnoderna i poolen. I Linux-poolen stöds endast "TemporaryDisk". i Windows-poolen måste "OsDisk" och "TemporaryDisk" anges. Utrymmessepererade måldiskar som ska krypteras. Värden kan antingen vara OsDisk eller TemporaryDisk.

--task-slots-per-node

Antalet aktivitetsfack som kan användas för att köra samtidiga uppgifter på en enda beräkningsnod i poolen. Standardvärdet är 1. Det maximala värdet är mindre än 4 gånger antalet kärnor i vmSize för poolen eller 256.

--upgrade-policy-mode

Läget för uppgraderingen av pooloperativsystemet.

accepterade värden: automatic, manual, rolling
--use-rolling-upgrade-policy

Anger om principen för löpande uppgradering ska användas under automatisk operativsystemuppgradering. Automatisk os-uppgradering återgår till standardprincipen om ingen princip har definierats på VMSS. Sant om flaggan finns.

accepterade värden: false, true
--vm-size

Obligatoriskt. Information om tillgängliga storlekar på virtuella datorer för Cloud Services-pooler (pooler som skapats med cloudServiceConfiguration) finns i Storlekar för Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch stöder alla vm-storlekar för Cloud Services utom ExtraSmall, A1V2 och A2V2. Information om tillgängliga VM-storlekar för pooler med avbildningar från Virtual Machines Marketplace (pooler som skapats med virtualMachineConfiguration) finns i Storlekar för virtuella datorer (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) eller Storlekar för virtuella datorer (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch har stöd för alla storlekar på virtuella Azure-datorer förutom STANDARD_A0 och de med premiumlagring (STANDARD_GS, STANDARD_DS och STANDARD_DSV2-serien).

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

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

Skapa en Batch-pool i ett konto. När du skapar en pool väljer du argument från antingen Cloud Services Configuration eller Virtual Machine Configuration.

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]

Valfria parametrar

--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckeln. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamnet. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--application-licenses

Listan över programlicenser måste vara en delmängd av tillgängliga Batch-tjänstprogramlicenser. Om en licens begärs som inte stöds misslyckas skapande av pool.

--application-package-references

När du skapar en pool måste paketets program-ID vara fullständigt kvalificerat (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Ändringar i paketreferenser påverkar alla nya noder som ansluter till poolen, men påverkar inte beräkningsnoder som redan finns i poolen förrän de startas om eller omskapas. Det finns högst 10 paketreferenser för en viss pool.

--auto-scale-formula

Den här egenskapen får inte anges om enableAutoScale är inställt på false. Det krävs om enableAutoScale är inställt på true. Formeln kontrolleras för giltighet innan poolen skapas. Om formeln inte är giltig avvisar Batch-tjänsten begäran med detaljerad felinformation. Mer information om hur du anger den här formeln finns i "Skala beräkningsnoder automatiskt i en Azure Batch-pool" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

--certificate-references

För Windows-noder installerar Batch-tjänsten certifikaten till det angivna certifikatarkivet och platsen. För Linux-beräkningsnoder lagras certifikaten i en katalog i arbetskatalogen Aktivitet och en miljövariabel AZ_BATCH_CERTIFICATES_DIR skickas till uppgiften för att fråga efter den här platsen. För certifikat med synlighet för "remoteUser" skapas en "certifikatkatalog" i användarens hemkatalog (t.ex. /home/{user-name}/certs) och Certifikat placeras i den katalogen. Varning! Den här egenskapen är inaktuell och tas bort efter februari 2024. Använd Azure KeyVault-tillägget i stället.

--disk-encryption-targets

En utrymmessepererad lista över DiskEncryptionTargets. aktuella möjliga värden är OsDisk och TemporaryDisk.

--enable-inter-node-communication

Om poolen tillåter direkt kommunikation mellan beräkningsnoder. Om kommunikation mellan noder aktiveras begränsas poolens maximala storlek på grund av distributionsbegränsningar för poolens beräkningsnoder. Detta kan leda till att poolen inte når önskad storlek. Standardvärdet är "false".

standardvärde: False
--id

Obligatoriskt. ID:t kan innehålla valfri kombination av alfanumeriska tecken, inklusive bindestreck och understreck, och får inte innehålla fler än 64 tecken. ID:t är skiftlägesbevarande och skiftlägesokänsligt (dvs. du kanske inte har två pool-ID:n inom ett konto som endast skiljer sig åt från fall till fall).

--image

Referens för OS-avbildning. Detta kan vara formatet "publisher:offer:sku[:version]" eller ett fullständigt kvalificerat ARM-avbildnings-ID för formuläret '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}'. Om formatet "publisher:offer:sku[:version]" är versionen valfri och om den senaste versionen utelämnas används den. Giltiga värden kan hämtas via "az batch pool node-agent-skus list". Exempel: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".

--json-file

Filen som innehåller poolen som ska skapas i JSON-format, om den här parametern anges, ignoreras alla andra parametrar.

--metadata

Batch-tjänsten tilldelar ingen betydelse för metadata. det är endast för användning av användarkod.

--node-agent-sku-id

SKU:n för Batch-nodagenten som ska etableras på beräkningsnoder i poolen. Batch-nodagenten är ett program som körs på varje nod i poolen och tillhandahåller kommando- och kontrollgränssnittet mellan noden och Batch-tjänsten. Det finns olika implementeringar av nodagenten, så kallade SKU:er, för olika operativsystem. Du måste ange en nodagent-SKU som matchar den valda bildreferensen. Information om hur du hämtar listan över nodagent-SKU:er som stöds tillsammans med deras lista över verifierade bildreferenser finns i åtgärden "List supported node agent SKU:er".

--os-family

Azure Guest OS-familjen som ska installeras på de virtuella datorerna i poolen. Möjliga värden är: 2 – OS Family 2, motsvarande Windows Server 2008 R2 SP1. 3 – OS Family 3, motsvarande Windows Server 2012. 4 – OS Family 4, motsvarande Windows Server 2012 R2. 5 – OS Family 5, motsvarande Windows Server 2016. Mer information finns i Azure Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). Tillåtna värden: 2, 3, 4, 5.

--os-version

Standardvärdet är * som anger den senaste operativsystemversionen för den angivna operativsystemfamiljen.

--parameters

Parametervärden för en JSON-mallfil för Batch-pool. Kan bara användas med --template.

--policy

Principtyp för nodplacering i Batch-pooler. Allokeringsprincip som används av Batch Service för att etablera noderna. Om det inte anges använder Batch regionalprincipen. Tillåtna värden: regional, zonindelad.

--resize-timeout

Den här tidsgränsen gäller endast för manuell skalning. det har ingen effekt när enableAutoScale är inställt på sant. Standardvärdet är 15 minuter. Minimivärdet är 5 minuter. Om du anger ett värde som är mindre än 5 minuter returnerar Batch-tjänsten ett fel. Om du anropar REST-API:et direkt är HTTP-statuskoden 400 (felaktig begäran).

--resource-group

Resursgruppen för Batch-kontot.

--start-task-command-line

Kommandoraden för startaktiviteten. Kommandoraden körs inte under ett gränssnitt och kan därför inte dra nytta av gränssnittsfunktioner som miljövariabelexpansion. Om du vill dra nytta av sådana funktioner bör du anropa gränssnittet på kommandoraden, till exempel med hjälp av "cmd /c MyCommand" i Windows eller "/bin/sh -c MyCommand" i Linux.

--start-task-resource-files

En lista över filer som Batch-tjänsten laddar ned till beräkningsnoden innan kommandoraden körs. Utrymmesavgränsade resursreferenser i filnamn=httpurl-format.

--start-task-wait-for-success

Om Batch-tjänsten ska vänta tills startaktiviteten har slutförts (d.v.s. avsluta med slutkod 0) innan du schemalägger några aktiviteter på beräkningsnoden. Om sant och startaktiviteten misslyckas på en beräkningsnod, försöker Batch-tjänsten starta aktiviteten igen upp till maximalt antal återförsök (maxTaskRetryCount). Om aktiviteten fortfarande inte har slutförts efter alla återförsök markerar Batch-tjänsten beräkningsnoden oanvändbar och schemalägger inte aktiviteter till den. Det här villkoret kan identifieras via nodtillståndet och schemaläggningsfelinformationen. Om det är falskt väntar inte Batch-tjänsten på att startaktiviteten ska slutföras. I det här fallet kan andra aktiviteter börja köras på beräkningsnoden medan startaktiviteten fortfarande körs. och även om startaktiviteten misslyckas fortsätter nya aktiviteter att schemaläggas på noden. Standardvärdet är falskt. Sant om flaggan finns.

standardvärde: False
--target-dedicated-nodes

Önskat antal dedikerade beräkningsnoder i poolen. Den här egenskapen får inte anges om enableAutoScale är inställt på true. Om enableAutoScale är inställt på false måste du ange antingen targetDedicatedNodes, targetLowPriorityNodes eller båda.

--target-low-priority-nodes

Önskat antal beräkningsnoder med oanvänd kapacitet/låg prioritet i poolen. Den här egenskapen får inte anges om enableAutoScale är inställt på true. Om enableAutoScale är inställt på false måste du ange antingen targetDedicatedNodes, targetLowPriorityNodes eller båda.

--targets

Om det utelämnas krypteras inga diskar på beräkningsnoderna i poolen. I Linux-poolen stöds endast "TemporaryDisk". i Windows-poolen måste "OsDisk" och "TemporaryDisk" anges. Utrymmessepererade måldiskar som ska krypteras. Värden kan antingen vara OsDisk eller TemporaryDisk.

--task-slots-per-node

Antalet aktivitetsfack som kan användas för att köra samtidiga uppgifter på en enda beräkningsnod i poolen. Standardvärdet är 1. Det maximala värdet är mindre än 4 gånger antalet kärnor i vmSize för poolen eller 256.

--template

En JSON-mallfil för Batch-pool. Om den här parametern anges ignoreras alla andra parametrar.

--vm-size

Obligatoriskt. Information om tillgängliga storlekar på virtuella datorer för Cloud Services-pooler (pooler som skapats med cloudServiceConfiguration) finns i Storlekar för Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch stöder alla vm-storlekar för Cloud Services utom ExtraSmall, A1V2 och A2V2. Information om tillgängliga VM-storlekar för pooler med avbildningar från Virtual Machines Marketplace (pooler som skapats med virtualMachineConfiguration) finns i Storlekar för virtuella datorer (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) eller Storlekar för virtuella datorer (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch har stöd för alla storlekar på virtuella Azure-datorer förutom STANDARD_A0 och de med premiumlagring (STANDARD_GS, STANDARD_DS och STANDARD_DSV2-serien).

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az batch pool delete

Tar bort en pool från det angivna kontot.

När du begär att en pool ska tas bort utförs följande åtgärder: Pooltillståndet är inställt på att ta bort; alla pågående storleksändringsåtgärder i poolen stoppas. Batch-tjänsten börjar ändra storlek på poolen till noll beräkningsnoder. Alla aktiviteter som körs på befintliga beräkningsnoder avslutas och sparas på nytt (som om en storleksändringsåtgärd för pool hade begärts med standardalternativet för att spara). Slutligen tas poolen bort från systemet. Eftersom aktiviteter som körs hämtas på nytt kan användaren köra aktiviteterna igen genom att uppdatera sitt jobb för att rikta in sig på en annan pool. Aktiviteterna kan sedan köras på den nya poolen. Om du vill åsidosätta återköbeteendet bör du anropa ändra storlek på poolen explicit för att minska poolen till nollstorlek innan du tar bort poolen. Om du anropar ett API för uppdatering, korrigering eller borttagning i en pool i borttagningstillståndet misslyckas det med HTTP-statuskod 409 med felkoden 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]

Obligatoriska parametrar

--pool-id

ID:t för poolen som ska tas bort.

Valfria parametrar

--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--if-match

Ett ETag-värde som är associerat med den version av resursen som är känd för klienten. Åtgärden utförs endast om resursens aktuella ETag på tjänsten exakt matchar det värde som anges av klienten.

--if-modified-since

En tidsstämpel som anger den senaste ändrade tiden för resursen som är känd för klienten. Åtgärden utförs endast om resursen i tjänsten har ändrats sedan den angivna tiden.

--if-none-match

Ett ETag-värde som är associerat med den version av resursen som är känd för klienten. Åtgärden utförs endast om resursens aktuella ETag på tjänsten inte matchar det värde som anges av klienten.

--if-unmodified-since

En tidsstämpel som anger den senaste ändrade tiden för resursen som är känd för klienten. Åtgärden utförs endast om resursen på tjänsten inte har ändrats sedan den angivna tiden.

--yes -y

Fråga inte efter bekräftelse.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az batch pool list

Visar en lista över alla pooler i det angivna kontot.

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

Valfria parametrar

--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--expand

En OData-$expand-sats.

--filter

En OData-$filter-sats. Mer information om hur du skapar det här filtret finns i https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-pools.

--select

En OData-$select-sats.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az batch pool reset

Uppdatera egenskaperna för en Batch-pool. Ospecificerade egenskaper som kan uppdateras återställs till standardinställningarna.

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]

Obligatoriska parametrar

--pool-id

ID:t för poolen som ska uppdateras.

Valfria parametrar

--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckeln. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamnet. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--application-package-references

Obligatoriskt. Listan ersätter alla befintliga programpaketreferenser i poolen. Ändringar i programpaketreferenser påverkar alla nya beräkningsnoder som ansluter till poolen, men påverkar inte beräkningsnoder som redan finns i poolen förrän de startas om eller omskapas. Det finns högst 10 programpaketreferenser i en viss pool. Om det utelämnas, eller om du anger en tom samling, tas alla befintliga programpaketreferenser bort från poolen. Högst 10 referenser kan anges i en viss pool.

--certificate-references

Obligatoriskt. Den här listan ersätter alla befintliga certifikatreferenser som konfigurerats i poolen. Om du anger en tom samling tas alla befintliga certifikatreferenser bort från poolen. För Windows-noder installerar Batch-tjänsten certifikaten till det angivna certifikatarkivet och platsen. För Linux-beräkningsnoder lagras certifikaten i en katalog i arbetskatalogen Aktivitet och en miljövariabel AZ_BATCH_CERTIFICATES_DIR skickas till uppgiften för att fråga efter den här platsen. För certifikat med synlighet för "remoteUser" skapas en "certifikatkatalog" i användarens hemkatalog (t.ex. /home/{user-name}/certs) och Certifikat placeras i den katalogen. Varning! Den här egenskapen är inaktuell och tas bort efter februari 2024. Använd Azure KeyVault-tillägget i stället.

--json-file

Filen som innehåller parameterspecifikationen för pooluppdateringsegenskaper i JSON(formaterad för att matcha REST API-begärandetexten). Om den här parametern anges ignoreras alla "Parameterargument för pooluppdateringsegenskaper".

--metadata

Obligatoriskt. Den här listan ersätter alla befintliga metadata som konfigurerats i poolen. Om det utelämnas, eller om du anger en tom samling, tas befintliga metadata bort från poolen.

--start-task-command-line

Kommandoraden för startaktiviteten. Kommandoraden körs inte under ett gränssnitt och kan därför inte dra nytta av gränssnittsfunktioner som miljövariabelexpansion. Om du vill dra nytta av sådana funktioner bör du anropa gränssnittet på kommandoraden, till exempel med hjälp av "cmd /c MyCommand" i Windows eller "/bin/sh -c MyCommand" i Linux.

--start-task-environment-settings

En lista över miljövariabelinställningar för startaktiviteten. Blankstegsavgränsade värden i formatet "key=value".

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

Det maximala antalet gånger som aktiviteten kan försökas igen.

--start-task-wait-for-success

Om Batch-tjänsten ska vänta tills startaktiviteten har slutförts (d.v.s. avsluta med slutkod 0) innan du schemalägger några aktiviteter på beräkningsnoden. Sant om flaggan finns, annars standardvärdet False.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az batch pool resize

Ändra storlek på eller sluta ändra storlek på en 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]

Obligatoriska parametrar

--pool-id

ID:t för poolen.

Valfria parametrar

--abort

Stoppa åtgärden för att ändra storlek på poolen.

standardvärde: False
--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckeln. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamnet. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--if-match

Åtgärden utförs endast om resursens aktuella ETag exakt matchar det angivna värdet.

--if-modified-since

Åtgärden utförs endast om resursen har ändrats sedan den angivna tidsstämpeln.

--if-none-match

Åtgärden utförs inte bara om resursens aktuella ETag exakt matchar det angivna värdet.

--if-unmodified-since

Åtgärden utförs inte bara om resursen har ändrats sedan den angivna tidsstämpeln.

--node-deallocation-option

När noder kan tas bort från poolen, om poolstorleken minskar.

accepterade värden: requeue, retaineddata, taskcompletion, terminate
--resize-timeout

Standardvärdet är 15 minuter. Minimivärdet är 5 minuter. Om du anger ett värde som är mindre än 5 minuter returnerar Batch-tjänsten ett fel. Om du anropar REST-API:et direkt är HTTP-statuskoden 400 (felaktig begäran).

--target-dedicated-nodes

Önskat antal dedikerade beräkningsnoder i poolen.

--target-low-priority-nodes

Önskat antal beräkningsnoder med oanvänd kapacitet/låg prioritet i poolen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az batch pool set

Uppdatera egenskaperna för en Batch-pool. Om du uppdaterar en egenskap i en undergrupp återställs de ospecificerade egenskaperna för gruppen.

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

Obligatoriska parametrar

--pool-id

ID:t för poolen som ska uppdateras.

Valfria parametrar

--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--application-package-references

Ändringar i paketreferenser påverkar alla nya noder som ansluter till poolen, men påverkar inte beräkningsnoder som redan finns i poolen förrän de startas om eller omskapas. Om det här elementet finns ersätter det alla befintliga paketreferenser. Om du anger en tom samling tas alla paketreferenser bort från poolen. Om de utelämnas lämnas alla befintliga paketreferenser oförändrade. Utrymmesavgränsade program-ID:er med valfri version i formatet "id[#version]".

--certificate-references

Om det här elementet finns ersätter det alla befintliga certifikatreferenser som konfigurerats i poolen. Om de utelämnas lämnas alla befintliga certifikatreferenser oförändrade. För Windows-noder installerar Batch-tjänsten certifikaten till det angivna certifikatarkivet och platsen. För Linux-beräkningsnoder lagras certifikaten i en katalog i arbetskatalogen Aktivitet och en miljövariabel AZ_BATCH_CERTIFICATES_DIR skickas till uppgiften för att fråga efter den här platsen. För certifikat med synlighet för "remoteUser" skapas en "certifikatkatalog" i användarens hemkatalog (t.ex. /home/{user-name}/certs) och Certifikat placeras i den katalogen. Varning! Den här egenskapen är inaktuell och tas bort efter februari 2024. Använd Azure KeyVault-tillägget i stället. Tumavtryck för blankstegsavgränsade certifikat.

--if-match

Ett ETag-värde som är associerat med den version av resursen som är känd för klienten. Åtgärden utförs endast om resursens aktuella ETag på tjänsten exakt matchar det värde som anges av klienten.

--if-modified-since

En tidsstämpel som anger den senaste ändrade tiden för resursen som är känd för klienten. Åtgärden utförs endast om resursen i tjänsten har ändrats sedan den angivna tiden.

--if-none-match

Ett ETag-värde som är associerat med den version av resursen som är känd för klienten. Åtgärden utförs endast om resursens aktuella ETag på tjänsten inte matchar det värde som anges av klienten.

--if-unmodified-since

En tidsstämpel som anger den senaste ändrade tiden för resursen som är känd för klienten. Åtgärden utförs endast om resursen på tjänsten inte har ändrats sedan den angivna tiden.

--json-file

En fil som innehåller parameterspecifikationen för poolkorrigering i JSON (formaterad för att matcha respektive REST API-brödtext). Om den här parametern anges ignoreras alla "poolargument".

--metadata

Om det här elementet finns ersätter det alla befintliga metadata som konfigurerats i poolen. Om du anger en tom samling tas alla metadata bort från poolen. Om de utelämnas lämnas alla befintliga metadata oförändrade. Blankstegsavgränsade värden i formatet "key=value".

--start-task-command-line

Obligatoriskt. Kommandoraden körs inte under ett gränssnitt och kan därför inte dra nytta av gränssnittsfunktioner som miljövariabelexpansion. Om du vill dra nytta av sådana funktioner bör du anropa gränssnittet på kommandoraden, till exempel med hjälp av "cmd /c MyCommand" i Windows eller "/bin/sh -c MyCommand" i Linux. Om kommandoraden refererar till filsökvägar bör den använda en relativ sökväg (i förhållande till arbetskatalogen Uppgift) eller använda miljövariabeln Batch som tillhandahålls (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--start-task-environment-settings

Blankstegsavgränsade värden i formatet "key=value".

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

Det maximala antalet gånger som aktiviteten kan försökas igen. Batch-tjänsten försöker utföra en aktivitet igen om slutkoden inte är noll. Observera att det här värdet specifikt styr antalet återförsök. Batch-tjänsten provar uppgiften en gång och kan sedan försöka upp till den här gränsen igen. Om det maximala antalet återförsök till exempel är 3, försöker Batch aktiviteten upp till 4 gånger (ett första försök och 3 återförsök). Om det maximala antalet återförsök är 0 försöker inte Batch-tjänsten uppgiften igen. Om det maximala antalet återförsök är -1 försöker Batch-tjänsten aktiviteten utan begränsning igen, men detta rekommenderas inte för en startaktivitet eller någon aktivitet. Standardvärdet är 0 (inga återförsök).

--start-task-resource-files

Filer som visas under det här elementet finns i arbetskatalogen för aktiviteten. Utrymmesavgränsade resursreferenser i filnamn=httpurl-format.

--start-task-wait-for-success

Om Batch-tjänsten ska vänta tills StartTask har slutförts (d.v.s. avsluta med slutkod 0) innan du schemalägger aktiviteter på beräkningsnoden. Om true och StartTask misslyckas på en nod, försöker Batch-tjänsten starta om StartTask upp till det maximala antalet återförsök (maxTaskRetryCount). Om aktiviteten fortfarande inte har slutförts efter alla återförsök markerar Batch-tjänsten noden oanvändbar och schemalägger inte Aktiviteter till den. Det här villkoret kan identifieras via beräkningsnodens tillstånd och information om felinformation. Om det är falskt väntar inte Batch-tjänsten på att StartTask ska slutföras. I det här fallet kan andra uppgifter börja köras på beräkningsnoden medan StartTask fortfarande körs. och även om StartTask misslyckas fortsätter nya aktiviteter att schemaläggas på beräkningsnoden. Standardvärdet är sant. Ange antingen "true" eller "false" för att uppdatera egenskapen.

--target-communication

Önskat nodkommunikationsläge för poolen. Om det här elementet finns ersätter det befintliga targetNodeCommunicationMode som konfigurerats i poolen. Om de utelämnas lämnas alla befintliga metadata oförändrade.

accepterade värden: classic, default, simplified
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az batch pool show

Hämtar information om den angivna poolen.

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]

Obligatoriska parametrar

--pool-id

ID:t för poolen som ska hämtas.

Valfria parametrar

--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--expand

En OData-$expand-sats.

--if-match

Ett ETag-värde som är associerat med den version av resursen som är känd för klienten. Åtgärden utförs endast om resursens aktuella ETag på tjänsten exakt matchar det värde som anges av klienten.

--if-modified-since

En tidsstämpel som anger den senaste ändrade tiden för resursen som är känd för klienten. Åtgärden utförs endast om resursen i tjänsten har ändrats sedan den angivna tiden.

--if-none-match

Ett ETag-värde som är associerat med den version av resursen som är känd för klienten. Åtgärden utförs endast om resursens aktuella ETag på tjänsten inte matchar det värde som anges av klienten.

--if-unmodified-since

En tidsstämpel som anger den senaste ändrade tiden för resursen som är känd för klienten. Åtgärden utförs endast om resursen på tjänsten inte har ändrats sedan den angivna tiden.

--select

En OData-$select-sats.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.