az batch pool

Uwaga

Ta grupa poleceń zawiera polecenia zdefiniowane zarówno w interfejsie wiersza polecenia platformy Azure, jak i w co najmniej jednym rozszerzeniu. Zainstaluj każde rozszerzenie, aby korzystać z rozszerzonych możliwości. Dowiedz się więcej o rozszerzeniach.

Zarządzanie pulami usługi Batch.

Polecenia

Nazwa Opis Typ Stan
az batch pool autoscale

Zarządzanie automatycznym skalowaniem pul usługi Batch.

Podstawowe funkcje Ogólna dostępność
az batch pool autoscale disable

Wyłącza automatyczne skalowanie puli.

Podstawowe funkcje Ogólna dostępność
az batch pool autoscale enable

Włącza automatyczne skalowanie dla puli.

Podstawowe funkcje Ogólna dostępność
az batch pool autoscale evaluate

Pobiera wynik oceny formuły automatycznego skalowania w puli.

Podstawowe funkcje Ogólna dostępność
az batch pool create

Utwórz pulę usługi Batch na koncie. Podczas tworzenia puli wybierz argumenty z konfiguracji usług Cloud Services lub konfiguracji maszyny wirtualnej.

Podstawowe funkcje Ogólna dostępność
az batch pool create (azure-batch-cli-extensions rozszerzenie)

Utwórz pulę usługi Batch na koncie. Podczas tworzenia puli wybierz argumenty z konfiguracji usług Cloud Services lub konfiguracji maszyny wirtualnej.

Numer wewnętrzny Ogólna dostępność
az batch pool delete

Usuwa pulę z określonego konta.

Podstawowe funkcje Ogólna dostępność
az batch pool list

Wyświetla listę wszystkich pul w określonym koncie.

Podstawowe funkcje Ogólna dostępność
az batch pool node-counts

Pobieranie liczby węzłów dla pul usługi Batch.

Podstawowe funkcje Ogólna dostępność
az batch pool node-counts list

Pobiera liczbę węzłów obliczeniowych w każdym stanie pogrupowanych według puli.

Podstawowe funkcje Ogólna dostępność
az batch pool reset

Zaktualizuj właściwości puli usługi Batch. Nieokreślone właściwości, które można zaktualizować, są resetowane do ich wartości domyślnych.

Podstawowe funkcje Ogólna dostępność
az batch pool resize

Zmiana rozmiaru lub zatrzymanie zmiany rozmiaru puli usługi Batch.

Podstawowe funkcje Ogólna dostępność
az batch pool set

Zaktualizuj właściwości puli usługi Batch. Aktualizowanie właściwości w podgrupie spowoduje zresetowanie nieokreślonych właściwości tej grupy.

Podstawowe funkcje Ogólna dostępność
az batch pool show

Pobiera informacje o określonej puli.

Podstawowe funkcje Ogólna dostępność
az batch pool supported-images

Wykonywanie zapytań dotyczących obrazów maszyn wirtualnych obsługiwanych przez usługę Azure Batch.

Podstawowe funkcje Ogólna dostępność
az batch pool supported-images list

Wyświetla listę wszystkich obrazów maszyn wirtualnych obsługiwanych przez usługę Azure Batch.

Podstawowe funkcje Ogólna dostępność
az batch pool usage-metrics

Wyświetlanie metryk użycia pul usługi Batch.

Podstawowe funkcje Ogólna dostępność
az batch pool usage-metrics list

Wyświetla listę metryk użycia, agregowanych według puli w poszczególnych interwałach czasu dla określonego konta.

Podstawowe funkcje Ogólna dostępność

az batch pool create

Utwórz pulę usługi Batch na koncie. Podczas tworzenia puli wybierz argumenty z konfiguracji usług Cloud Services lub konfiguracji maszyny wirtualnej.

az batch pool create [--accelerated-networking {false, true}]
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--application-licenses]
                     [--application-package-references]
                     [--auto-scale-formula]
                     [--certificate-references]
                     [--disk-encryption-targets]
                     [--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]
                     [--metadata]
                     [--node-agent-sku-id]
                     [--os-disk-caching {none, readonly, readwrite}]
                     [--os-disk-size]
                     [--os-family {2, 3, 4, 5, 6}]
                     [--os-version]
                     [--placement {cachedisk}]
                     [--policy {regional, zonal}]
                     [--resize-timeout]
                     [--resource-tags]
                     [--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]
                     [--vm-size]

Parametry opcjonalne

--accelerated-networking

Czy ta pula powinna włączyć przyspieszoną sieć. Przyspieszona sieć umożliwia wirtualizację we/wy pojedynczego katalogu głównego (SR-IOV) do maszyny wirtualnej, co może prowadzić do zwiększenia wydajności sieci. Aby uzyskać więcej informacji, zobacz: https://learn.microsoft.com/azure/virtual- network/accelerated-networking-overview (Omówienie sieci/przyspieszonej sieci). Ustaw wartość true, aby włączyć.

akceptowane wartości: false, true
--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--application-licenses

Lista licencji aplikacji musi być podzbiorem dostępnych licencji aplikacji usługi Batch. Jeśli zażądano licencji, która nie jest obsługiwana, tworzenie puli zakończy się niepowodzeniem. Wartości rozdzielone spacjami.

--application-package-references

Podczas tworzenia puli identyfikator aplikacji pakietu musi być w pełni kwalifikowany (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Zmiany odwołań do pakietu mają wpływ na wszystkie nowe węzły łączące pulę, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub zrewidowane. W danej puli istnieje maksymalnie 10 odwołań do pakietu. Identyfikatory aplikacji rozdzielone spacjami z opcjonalną wersją w formacie "id[#version]".

--auto-scale-formula

Formuła dla żądanej liczby węzłów obliczeniowych w puli. Formuła jest sprawdzana pod kątem ważności przed utworzeniem puli. Jeśli formuła jest nieprawidłowa, usługa Batch odrzuca żądanie ze szczegółowymi informacjami o błędzie. Aby uzyskać więcej informacji na temat określania tej formuły, zobacz https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/.

--certificate-references

W przypadku węzłów systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadanie, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania, aby wykonać zapytanie o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu. Ostrzeżenie: Ta właściwość jest przestarzała i zostanie usunięta po lutym 2024 r. Zamiast tego użyj rozszerzenia Azure KeyVault. Odciski palca certyfikatu rozdzielane spacjami.

--disk-encryption-targets

Rozdzielona spacją lista DiskEncryptionTargets. bieżące możliwe wartości obejmują OsDisk i TemporaryDisk.

--enable-inter-node-communication

Określa, czy pula zezwala na bezpośrednią komunikację między węzłami obliczeniowymi. Włączenie komunikacji między węzłami ogranicza maksymalny rozmiar puli z powodu ograniczeń wdrażania w węzłach obliczeniowych puli. Może to spowodować, że pula nie osiągnie żądanego rozmiaru. Wartość domyślna to false. Prawda, jeśli flaga jest obecna.

--enable-secure-boot

Włącz bezpieczny rozruch.

akceptowane wartości: false, true
--enable-vtpm

Włącz maszynę wirtualną vTPM.

akceptowane wartości: false, true
--enable-write-accel

Określ, czy na dysku ma być włączony lub wyłączony moduł writeAccelerator.

akceptowane wartości: false, true
--encryption-at-host

Ta właściwość może być używana przez użytkownika w żądaniu włączenia lub wyłączenia szyfrowania hosta dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych. Spowoduje to włączenie szyfrowania dla wszystkich dysków, w tym dysku zasobu/tymczasowego na samym hoście. Domyślne zachowanie to: Szyfrowanie na hoście zostanie wyłączone, chyba że ta właściwość ma wartość true dla zasobu.

akceptowane wartości: false, true
--id

Wymagany. Identyfikator może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaków. Identyfikator zachowuje wielkość liter i nie uwzględnia wielkości liter (oznacza to, że w ramach konta nie ma dwóch identyfikatorów puli, które różnią się tylko wielkością liter).

--image

Dokumentacja obrazu systemu operacyjnego. Może to być format "publisher:offer:sku[:version]" lub w pełni kwalifikowany identyfikator obrazu usługi ARM formularza "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}". Jeśli format "publisher:offer:sku[:version]" jest opcjonalny, a jeśli pominięto najnowszą wersję, zostanie użyta. Prawidłowe wartości można pobrać za pomocą polecenia "az batch pool supported-images list". Na przykład: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".

--json-file

Plik zawierający specyfikację parametru właściwości w formacie JSON (sformatowany w celu dopasowania do treści żądania interfejsu API REST). Jeśli ten parametr zostanie określony, wszystkie argumenty parametru "Utwórz pulę właściwości" są ignorowane. Zobacz: https://docs.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#request-body.

--metadata

Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika. Wartości rozdzielone spacjami w formacie "key=value".

--node-agent-sku-id

Wymagany. Agent węzła obliczeniowego usługi Batch to program uruchamiany w każdym węźle obliczeniowym w puli i udostępnia interfejs polecenia i sterowania między węzłem obliczeniowym a usługą Batch. Istnieją różne implementacje agenta węzła obliczeniowego nazywanego jednostkami SKU dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła obliczeniowego zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła obliczeniowego wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła obliczeniowego".

--os-disk-caching

Określ wymagania dotyczące buforowania. Możliwe wartości to: None, ReadOnly, ReadWrite. Wartości domyślne to: Brak w przypadku magazynu w warstwie Standardowa. Funkcja ReadOnly dla usługi Premium Storage.

akceptowane wartości: none, readonly, readwrite
--os-disk-size

Początkowy rozmiar dysku w GB podczas tworzenia nowego dysku systemu operacyjnego.

--os-family

Wymagany. Możliwe wartości to: 2 — Rodzina systemu operacyjnego 2, co odpowiada systemowi Windows Server 2008 R2 z dodatkiem SP1. 3 — Rodzina systemu operacyjnego 3, co odpowiada systemowi Windows Server 2012. 4 — Rodzina systemów operacyjnych 4, równoważna windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, co odpowiada systemowi Windows Server 2016. 6 — Rodzina systemów operacyjnych 6, co odpowiada systemowi Windows Server 2019. Aby uzyskać więcej informacji, zobacz Wydania systemu operacyjnego gościa platformy Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).

akceptowane wartości: 2, 3, 4, 5, 6
--os-version

Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemów operacyjnych.

--placement

Określa efemeryczne umieszczanie dysku dla dysku systemu operacyjnego dla wszystkich maszyn wirtualnych w puli. Ta właściwość może być używana przez użytkownika w żądaniu, aby wybrać lokalizację, np. miejsce na dysku pamięci podręcznej na potrzeby aprowizacji dysku efemerycznego systemu operacyjnego. Aby uzyskać więcej informacji na temat wymagań dotyczących rozmiaru dysku systemu operacyjnego efemerycznego, zapoznaj się z wymaganiami dotyczącymi rozmiaru dysku efemerycznego systemu operacyjnego dla maszyn wirtualnych z systemem Windows w https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements witrynie i maszynami wirtualnymi z systemem Linux pod adresem https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

akceptowane wartości: cachedisk
--policy

Typ zasad umieszczania węzła w pulach usługi Batch. Zasady alokacji używane przez usługę Batch do aprowizowania węzłów. Jeśli nie zostanie określony, usługa Batch użyje zasad regionalnych.

akceptowane wartości: regional, zonal
--resize-timeout

Ten limit czasu dotyczy tylko skalowania ręcznego; nie ma żadnego wpływu, gdy parametr enableAutoScale jest ustawiony na wartość true. Wartość domyślna to 15 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch zwróci błąd; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie). Oczekiwany format to czas trwania ISO-8601.

--resource-tags

Użytkownik może określić tagi zasobów dla puli. Każdy zasób utworzony dla puli zostanie również otagowany przez te same tagi zasobów.

--security-type

Określ wartość SecurityType maszyny wirtualnej. Należy ustawić dowolną określoną wartość, aby włączyć interfejs Uefi Ustawienia. Domyślne zachowanie to: Uefi Ustawienia nie zostanie włączone, chyba że ta właściwość jest ustawiona.

--start-task-command-line

Wymagany. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz korzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Jeśli wiersz polecenia odwołuje się do ścieżek plików, powinien użyć ścieżki względnej (względem katalogu roboczego zadania) lub użyć zmiennej środowiskowej udostępnionej w usłudze Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--start-task-resource-files

Pliki wymienione w ramach tego elementu znajdują się w katalogu roboczym zadania. Odwołania do zasobów rozdzielonych spacjami w formacie nazwa_pliku=httpurl.

--start-task-wait-for-success

Czy usługa Batch powinna czekać na pomyślne zakończenie zadania StartTask (czyli zakończenie z kodem zakończenia 0) przed zaplanowaniem zadań w węźle obliczeniowym. Jeśli wartość true i parametr StartTask zakończy się niepowodzeniem w węźle, usługa Batch ponawia próbę do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po ponownych próbach, usługa Batch oznacza węzeł bezużyteczny i nie będzie planować zadań do niego. Ten warunek można wykryć za pomocą szczegółów stanu węzła obliczeniowego i informacji o błędzie. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania StartTask. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy funkcja StartTask jest nadal uruchomiona; a nawet jeśli zadanie StartTask zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle obliczeniowym. Wartość domyślna to true. Prawda, jeśli flaga jest obecna.

--storage-account-type

Typ konta magazynu dla dysku zarządzanego.

akceptowane wartości: premium_lrs, standard_lrs, standardssd_lrs
--target-communication

Żądany tryb komunikacji węzła dla puli. Jeśli ten element jest obecny, zastępuje istniejący element targetNodeCommunicationMode skonfigurowany w puli. Jeśli pominięto, wszystkie istniejące metadane pozostaną niezmienione.

akceptowane wartości: classic, default, simplified
--target-dedicated-nodes

Żądana liczba dedykowanych węzłów obliczeniowych w puli. Nie można określić tej właściwości, jeśli parametr enableAutoScale jest ustawiony na wartość true. Jeśli parametr enableAutoScale ma wartość false, należy ustawić element targetDedicatedNodes, targetLowPriorityNodes lub oba te elementy.

--target-low-priority-nodes

Żądana liczba węzłów obliczeniowych typu spot/o niskim priorytcie w puli. Nie można określić tej właściwości, jeśli parametr enableAutoScale jest ustawiony na wartość true. Jeśli parametr enableAutoScale ma wartość false, należy ustawić element targetDedicatedNodes, targetLowPriorityNodes lub oba te elementy.

--targets

W przypadku pominięcia żadne dyski w węzłach obliczeniowych w puli nie będą szyfrowane. W puli systemu Linux obsługiwana jest tylko opcja "TemporaryDisk"; w puli systemu Windows należy określić wartości "OsDisk" i "TemporaryDisk". Miejsca oddzielone dyski docelowe do szyfrowania. Wartości mogą być OsDisk lub TemporaryDisk.

--task-slots-per-node

Liczba miejsc zadań, których można użyć do uruchamiania współbieżnych zadań w jednym węźle obliczeniowym w puli. Domyślna wartość wynosi 1. Wartość maksymalna jest mniejsza od 4 razy liczbie rdzeni rozmiaru maszyny wirtualnej puli lub 256.

--vm-size

Wymagany. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul usług w chmurze (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla usług Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych usług Cloud Services z wyjątkiem ExtraSmall, A1V2 i A2V2. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul przy użyciu obrazów z witryny Marketplace maszyn wirtualnych (pul utworzonych za pomocą funkcji virtualMachineConfiguration), zobacz Rozmiary maszyn wirtualnych (Linux) () lubhttps://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ Rozmiary maszyn wirtualnych (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2).

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

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

Utwórz pulę usługi Batch na koncie. Podczas tworzenia puli wybierz argumenty z konfiguracji usług Cloud Services lub konfiguracji maszyny wirtualnej.

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]

Parametry opcjonalne

--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--application-licenses

Lista licencji aplikacji musi być podzbiorem dostępnych licencji aplikacji usługi Batch. Jeśli zażądano licencji, która nie jest obsługiwana, tworzenie puli zakończy się niepowodzeniem.

--application-package-references

Podczas tworzenia puli identyfikator aplikacji pakietu musi być w pełni kwalifikowany (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Zmiany odwołań do pakietu mają wpływ na wszystkie nowe węzły łączące pulę, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub zrewidowane. W danej puli istnieje maksymalnie 10 odwołań do pakietu.

--auto-scale-formula

Nie można określić tej właściwości, jeśli dla parametru enableAutoScale ustawiono wartość false. Jest to wymagane, jeśli wartość enableAutoScale jest ustawiona na wartość true. Formuła jest sprawdzana pod kątem ważności przed utworzeniem puli. Jeśli formuła jest nieprawidłowa, usługa Batch odrzuca żądanie ze szczegółowymi informacjami o błędzie. Aby uzyskać więcej informacji na temat określania tej formuły, zobacz "Automatyczne skalowanie węzłów obliczeniowych w puli usługi Azure Batch" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

--certificate-references

W przypadku węzłów systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadanie, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania, aby wykonać zapytanie o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu. Ostrzeżenie: Ta właściwość jest przestarzała i zostanie usunięta po lutym 2024 r. Zamiast tego użyj rozszerzenia Azure KeyVault.

--disk-encryption-targets

Oddzielona lista spacji DiskEncryptionTargets. bieżące możliwe wartości obejmują OsDisk i TemporaryDisk.

--enable-inter-node-communication

Określa, czy pula zezwala na bezpośrednią komunikację między węzłami obliczeniowymi. Włączenie komunikacji między węzłami ogranicza maksymalny rozmiar puli z powodu ograniczeń wdrażania w węzłach obliczeniowych puli. Może to spowodować, że pula nie osiągnie żądanego rozmiaru. Wartość domyślna to false.

wartość domyślna: False
--id

Wymagany. Identyfikator może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaków. Identyfikator zachowuje wielkość liter i nie uwzględnia wielkości liter (oznacza to, że w ramach konta nie ma dwóch identyfikatorów puli, które różnią się tylko wielkością liter).

--image

Dokumentacja obrazu systemu operacyjnego. Może to być format "publisher:offer:sku[:version]" lub w pełni kwalifikowany identyfikator obrazu usługi ARM formularza "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}". Jeśli format "publisher:offer:sku[:version]" jest opcjonalny, a jeśli pominięto najnowszą wersję, zostanie użyta. Prawidłowe wartości można pobrać za pomocą polecenia "az batch pool node-agent-skus list". Na przykład: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".

--json-file

Plik zawierający pulę do utworzenia w formacie JSON, jeśli ten parametr jest określony, wszystkie inne parametry są ignorowane.

--metadata

Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika.

--node-agent-sku-id

Jednostka SKU agenta węzła usługi Batch do aprowizowania w węzłach obliczeniowych w puli. Agent węzła usługi Batch to program uruchamiany w każdym węźle w puli i udostępnia interfejs polecenia i sterowania między węzłem a usługą Batch. Istnieją różne implementacje agenta węzła, znane jako jednostki SKU, dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła".

--os-family

Rodzina systemu operacyjnego gościa platformy Azure, która ma zostać zainstalowana na maszynach wirtualnych w puli. Możliwe wartości to: 2 — Rodzina systemu operacyjnego 2, co odpowiada systemowi Windows Server 2008 R2 z dodatkiem SP1. 3 — Rodzina systemu operacyjnego 3, co odpowiada systemowi Windows Server 2012. 4 — Rodzina systemów operacyjnych 4, równoważna windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, co odpowiada systemowi Windows Server 2016. Aby uzyskać więcej informacji, zobacz Wydania systemu operacyjnego gościa platformy Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). Dozwolone wartości: 2, 3, 4, 5.

--os-version

Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemów operacyjnych.

--parameters

Wartości parametrów dla pliku szablonu JSON puli usługi Batch. Można używać tylko z --template.

--policy

Typ zasad umieszczania węzła w pulach usługi Batch. Zasady alokacji używane przez usługę Batch do aprowizowania węzłów. Jeśli nie zostanie określony, usługa Batch użyje zasad regionalnych. Dozwolone wartości: regionalna, strefowa.

--resize-timeout

Ten limit czasu dotyczy tylko skalowania ręcznego; nie ma żadnego wpływu, gdy parametr enableAutoScale jest ustawiony na wartość true. Wartość domyślna to 15 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch zwróci błąd; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).

--resource-group

Grupa zasobów konta usługi Batch.

--start-task-command-line

Wiersz polecenia zadania uruchamiania. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz korzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux.

--start-task-resource-files

Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. Odwołania do zasobów rozdzielonych spacjami w formacie nazwa_pliku=httpurl.

--start-task-wait-for-success

Czy usługa Batch powinna czekać na pomyślne zakończenie zadania uruchamiania (czyli zakończenie z kodem zakończenia 0) przed zaplanowaniem zadań w węźle obliczeniowym. Jeśli wartość true i zadanie uruchamiania zakończy się niepowodzeniem w węźle obliczeniowym, usługa Batch ponawia próbę zadania podrzędnego uruchamiania do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po ponownych próbach, usługa Batch oznaczy węzeł obliczeniowy jako bezużyteczny i nie będzie planować zadań podrzędnych. Ten warunek można wykryć za pomocą stanu węzła i szczegółów błędu planowania. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania uruchamiania. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy zadanie uruchamiania jest nadal uruchomione; a nawet jeśli zadanie uruchamiania zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle. Wartością domyślną jest false. Prawda, jeśli flaga jest obecna.

wartość domyślna: False
--target-dedicated-nodes

Żądana liczba dedykowanych węzłów obliczeniowych w puli. Nie można określić tej właściwości, jeśli parametr enableAutoScale jest ustawiony na wartość true. Jeśli parametr enableAutoScale ma wartość false, należy ustawić element targetDedicatedNodes, targetLowPriorityNodes lub oba te elementy.

--target-low-priority-nodes

Żądana liczba węzłów obliczeniowych typu spot/o niskim priorytcie w puli. Nie można określić tej właściwości, jeśli parametr enableAutoScale jest ustawiony na wartość true. Jeśli parametr enableAutoScale ma wartość false, należy ustawić element targetDedicatedNodes, targetLowPriorityNodes lub oba te elementy.

--targets

W przypadku pominięcia żadne dyski w węzłach obliczeniowych w puli nie będą szyfrowane. W puli systemu Linux obsługiwana jest tylko opcja "TemporaryDisk"; w puli systemu Windows należy określić wartości "OsDisk" i "TemporaryDisk". Miejsca oddzielone dyski docelowe do szyfrowania. Wartości mogą być OsDisk lub TemporaryDisk.

--task-slots-per-node

Liczba miejsc zadań, których można użyć do uruchamiania współbieżnych zadań w jednym węźle obliczeniowym w puli. Domyślna wartość wynosi 1. Wartość maksymalna jest mniejsza od 4 razy liczbie rdzeni rozmiaru maszyny wirtualnej puli lub 256.

--template

Plik szablonu JSON puli usługi Batch. Jeśli ten parametr zostanie określony, wszystkie inne parametry są ignorowane.

--vm-size

Wymagany. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul usług w chmurze (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla usług Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych usług Cloud Services z wyjątkiem ExtraSmall, A1V2 i A2V2. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul przy użyciu obrazów z witryny Marketplace maszyn wirtualnych (pul utworzonych za pomocą funkcji virtualMachineConfiguration), zobacz Rozmiary maszyn wirtualnych (Linux) () lubhttps://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ Rozmiary maszyn wirtualnych (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2).

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az batch pool delete

Usuwa pulę z określonego konta.

Gdy zażądasz usunięcia puli, zostaną wykonane następujące akcje: stan puli zostanie ustawiony na usunięcie; wszystkie trwające operacje zmiany rozmiaru w puli są zatrzymywane; usługa Batch rozpoczyna zmianę rozmiaru puli na zero węzłów obliczeniowych; wszystkie zadania uruchomione w istniejących węzłach obliczeniowych są przerywane i ponownie kolejkowane (tak jak w przypadku żądania operacji zmiany rozmiaru puli z domyślną opcją ponownej kolejki); na koniec pula zostanie usunięta z systemu. Ponieważ uruchomione zadania są ponownie kolejkowane, użytkownik może ponownie uruchomić te zadania, aktualizując zadanie w celu kierowania innej puli. Następnie zadania mogą być uruchamiane w nowej puli. Jeśli chcesz zastąpić zachowanie ponownej kolejki, należy jawnie wywołać zmianę rozmiaru puli, aby zmniejszyć pulę do zera przed usunięciem puli. Jeśli wywołasz interfejs API aktualizacji, poprawek lub usuwania w puli w stanie usuwania, kod stanu HTTP 409 z kodem błędu PoolBeingDeleted zakończy się niepowodzeniem.

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

Parametry wymagane

--pool-id

Identyfikator puli do usunięcia.

Parametry opcjonalne

--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--if-match

Wartość elementu ETag skojarzona z wersją zasobu znaną klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze dokładnie odpowiada wartości określonej przez klienta.

--if-modified-since

Sygnatura czasowa wskazująca czas ostatniej modyfikacji zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy zasób w usłudze został zmodyfikowany od określonego czasu.

--if-none-match

Wartość elementu ETag skojarzona z wersją zasobu znaną klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze nie jest zgodny z wartością określoną przez klienta.

--if-unmodified-since

Sygnatura czasowa wskazująca czas ostatniej modyfikacji zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy zasób usługi nie został zmodyfikowany od określonego czasu.

--yes -y

Nie monituj o potwierdzenie.

wartość domyślna: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az batch pool list

Wyświetla listę wszystkich pul w określonym koncie.

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

Parametry opcjonalne

--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--expand

Klauzula OData $expand.

--filter

Klauzula OData $filter. Aby uzyskać więcej informacji na temat konstruowania tego filtru, zobacz https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-pools.

--select

Klauzula OData $select.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az batch pool reset

Zaktualizuj właściwości puli usługi Batch. Nieokreślone właściwości, które można zaktualizować, są resetowane do ich wartości domyślnych.

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]

Parametry wymagane

--pool-id

Identyfikator puli do zaktualizowania.

Parametry opcjonalne

--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--application-package-references

Wymagany. Lista zastępuje wszystkie istniejące odwołania do pakietu aplikacji w puli. Zmiany odwołań do pakietu aplikacji mają wpływ na wszystkie nowe węzły obliczeniowe przyłączone do puli, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub zrewidowane. W danej puli istnieje maksymalnie 10 odwołań do pakietu aplikacji. Jeśli pominięto lub jeśli określisz pustą kolekcję, wszystkie istniejące odwołania do pakietów aplikacji zostaną usunięte z puli. W danej puli można określić maksymalnie 10 odwołań.

--certificate-references

Wymagany. Ta lista zastępuje wszystkie istniejące odwołania do certyfikatów skonfigurowane w puli. Jeśli określisz pustą kolekcję, wszystkie istniejące odwołania do certyfikatów zostaną usunięte z puli. W przypadku węzłów systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadanie, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania, aby wykonać zapytanie o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu. Ostrzeżenie: Ta właściwość jest przestarzała i zostanie usunięta po lutym 2024 r. Zamiast tego użyj rozszerzenia Azure KeyVault.

--json-file

Plik zawierający specyfikację parametru właściwości aktualizacji puli w formacie JSON (sformatowany w celu dopasowania do treści żądania interfejsu API REST). Jeśli ten parametr zostanie określony, wszystkie argumenty parametru aktualizacji puli zostaną zignorowane.

--metadata

Wymagany. Ta lista zastępuje wszystkie istniejące metadane skonfigurowane w puli. Jeśli pominięto lub jeśli określisz pustą kolekcję, wszystkie istniejące metadane zostaną usunięte z puli.

--start-task-command-line

Wiersz polecenia zadania uruchamiania. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz korzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux.

--start-task-environment-settings

Lista ustawień zmiennych środowiskowych dla zadania uruchamiania. Wartości rozdzielone spacjami w formacie "key=value".

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

Maksymalna liczba ponownych prób wykonania zadania.

--start-task-wait-for-success

Czy usługa Batch powinna czekać na pomyślne zakończenie zadania uruchamiania (czyli zakończenie z kodem zakończenia 0) przed zaplanowaniem zadań w węźle obliczeniowym. Prawda, jeśli flaga jest obecna, w przeciwnym razie wartość domyślna to False.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az batch pool resize

Zmiana rozmiaru lub zatrzymanie zmiany rozmiaru puli usługi Batch.

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

Parametry wymagane

--pool-id

Identyfikator puli.

Parametry opcjonalne

--abort

Zatrzymaj operację zmiany rozmiaru puli.

wartość domyślna: False
--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--if-match

Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu dokładnie odpowiada określonej wartości.

--if-modified-since

Operacja zostanie wykonana tylko wtedy, gdy zasób został zmodyfikowany od określonego znacznika czasu.

--if-none-match

Operacja nie zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu dokładnie pasuje do określonej wartości.

--if-unmodified-since

Operacja nie zostanie wykonana tylko wtedy, gdy zasób został zmodyfikowany od określonego znacznika czasu.

--node-deallocation-option

Gdy węzły mogą zostać usunięte z puli, jeśli rozmiar puli zostanie zmniejszony.

akceptowane wartości: requeue, retaineddata, taskcompletion, terminate
--resize-timeout

Wartość domyślna to 15 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch zwróci błąd; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).

--target-dedicated-nodes

Żądana liczba dedykowanych węzłów obliczeniowych w puli.

--target-low-priority-nodes

Żądana liczba węzłów obliczeniowych typu spot/o niskim priorytcie w puli.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az batch pool set

Zaktualizuj właściwości puli usługi Batch. Aktualizowanie właściwości w podgrupie spowoduje zresetowanie nieokreślonych właściwości tej grupy.

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

Parametry wymagane

--pool-id

Identyfikator puli do zaktualizowania.

Parametry opcjonalne

--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--application-package-references

Zmiany odwołań do pakietu mają wpływ na wszystkie nowe węzły łączące pulę, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub zrewidowane. Jeśli ten element jest obecny, zastępuje wszystkie istniejące odwołania do pakietu. Jeśli określisz pustą kolekcję, wszystkie odwołania do pakietu zostaną usunięte z puli. Jeśli pominięto, wszystkie istniejące odwołania do pakietu pozostaną niezmienione. Identyfikatory aplikacji rozdzielone spacjami z opcjonalną wersją w formacie "id[#version]".

--certificate-references

Jeśli ten element jest obecny, zastępuje wszystkie istniejące odwołania do certyfikatów skonfigurowane w puli. W przypadku pominięcia wszystkie istniejące odwołania do certyfikatów pozostaną niezmienione. W przypadku węzłów systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadanie, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania, aby wykonać zapytanie o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu. Ostrzeżenie: Ta właściwość jest przestarzała i zostanie usunięta po lutym 2024 r. Zamiast tego użyj rozszerzenia Azure KeyVault. Odciski palca certyfikatu rozdzielane spacjami.

--if-match

Wartość elementu ETag skojarzona z wersją zasobu znaną klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze dokładnie odpowiada wartości określonej przez klienta.

--if-modified-since

Sygnatura czasowa wskazująca czas ostatniej modyfikacji zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy zasób w usłudze został zmodyfikowany od określonego czasu.

--if-none-match

Wartość elementu ETag skojarzona z wersją zasobu znaną klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze nie jest zgodny z wartością określoną przez klienta.

--if-unmodified-since

Sygnatura czasowa wskazująca czas ostatniej modyfikacji zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy zasób usługi nie został zmodyfikowany od określonego czasu.

--json-file

Plik zawierający specyfikację parametru poprawki puli w formacie JSON (sformatowany w celu dopasowania do odpowiedniej treści interfejsu API REST). Jeśli ten parametr jest określony, wszystkie argumenty puli są ignorowane.

--metadata

Jeśli ten element jest obecny, zastępuje wszystkie istniejące metadane skonfigurowane w puli. Jeśli określisz pustą kolekcję, wszystkie metadane zostaną usunięte z puli. Jeśli pominięto, wszystkie istniejące metadane pozostaną niezmienione. Wartości rozdzielone spacjami w formacie "key=value".

--start-task-command-line

Wymagany. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz korzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Jeśli wiersz polecenia odwołuje się do ścieżek plików, powinien użyć ścieżki względnej (względem katalogu roboczego zadania) lub użyć zmiennej środowiskowej udostępnionej w usłudze Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--start-task-environment-settings

Wartości rozdzielone spacjami w formacie "key=value".

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

Maksymalna liczba ponownych prób wykonania zadania. Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest inny niżzer. Należy pamiętać, że ta wartość steruje liczbą ponownych prób. Usługa Batch spróbuje raz wykonać zadanie, a następnie może ponowić próbę do tego limitu. Jeśli na przykład maksymalna liczba ponownych prób wynosi 3, usługa Batch próbuje wykonać zadanie do 4 razy (jedna początkowa próba i 3 ponownych prób). Jeśli maksymalna liczba ponownych prób wynosi 0, usługa Batch nie ponowi próby wykonania zadania. Jeśli maksymalna liczba ponownych prób wynosi -1, usługa Batch ponawia próbę zadania bez limitu, jednak nie jest to zalecane w przypadku zadania podrzędnego uruchamiania ani żadnego zadania podrzędnego. Wartość domyślna to 0 (bez ponownych prób).

--start-task-resource-files

Pliki wymienione w ramach tego elementu znajdują się w katalogu roboczym zadania. Odwołania do zasobów rozdzielonych spacjami w formacie nazwa_pliku=httpurl.

--start-task-wait-for-success

Czy usługa Batch powinna czekać na pomyślne zakończenie zadania StartTask (czyli zakończenie z kodem zakończenia 0) przed zaplanowaniem zadań w węźle obliczeniowym. Jeśli wartość true i parametr StartTask zakończy się niepowodzeniem w węźle, usługa Batch ponawia próbę do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po ponownych próbach, usługa Batch oznacza węzeł bezużyteczny i nie będzie planować zadań do niego. Ten warunek można wykryć za pomocą szczegółów stanu węzła obliczeniowego i informacji o błędzie. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania StartTask. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy funkcja StartTask jest nadal uruchomiona; a nawet jeśli zadanie StartTask zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle obliczeniowym. Wartość domyślna to true. Określ wartość "true" lub "false", aby zaktualizować właściwość.

--target-communication

Żądany tryb komunikacji węzła dla puli. Jeśli ten element jest obecny, zastępuje istniejący element targetNodeCommunicationMode skonfigurowany w puli. Jeśli pominięto, wszystkie istniejące metadane pozostaną niezmienione.

akceptowane wartości: classic, default, simplified
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az batch pool show

Pobiera informacje o określonej puli.

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]

Parametry wymagane

--pool-id

Identyfikator puli do pobrania.

Parametry opcjonalne

--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--expand

Klauzula OData $expand.

--if-match

Wartość elementu ETag skojarzona z wersją zasobu znaną klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze dokładnie odpowiada wartości określonej przez klienta.

--if-modified-since

Sygnatura czasowa wskazująca czas ostatniej modyfikacji zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy zasób w usłudze został zmodyfikowany od określonego czasu.

--if-none-match

Wartość elementu ETag skojarzona z wersją zasobu znaną klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze nie jest zgodny z wartością określoną przez klienta.

--if-unmodified-since

Sygnatura czasowa wskazująca czas ostatniej modyfikacji zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy zasób usługi nie został zmodyfikowany od określonego czasu.

--select

Klauzula OData $select.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.