Freigeben über


Microsoft.Batch batchAccounts/pools 2017-09-01

Bicep-Ressourcendefinition

Der Ressourcentyp "batchAccounts/pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Batch/batchAccounts/pools-Ressource zu erstellen, fügen Sie der Vorlage die folgende Bicep hinzu.

resource symbolicname 'Microsoft.Batch/batchAccounts/pools@2017-09-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    applicationLicenses: [
      'string'
    ]
    applicationPackages: [
      {
        id: 'string'
        version: 'string'
      }
    ]
    certificates: [
      {
        id: 'string'
        storeLocation: 'string'
        storeName: 'string'
        visibility: [
          'string'
        ]
      }
    ]
    deploymentConfiguration: {
      cloudServiceConfiguration: {
        currentOSVersion: 'string'
        osFamily: 'string'
        targetOSVersion: 'string'
      }
      virtualMachineConfiguration: {
        dataDisks: [
          {
            caching: 'string'
            diskSizeGB: int
            lun: int
            storageAccountType: 'string'
          }
        ]
        imageReference: {
          id: 'string'
          offer: 'string'
          publisher: 'string'
          sku: 'string'
          version: 'string'
        }
        licenseType: 'string'
        nodeAgentSkuId: 'string'
        osDisk: {
          caching: 'string'
        }
        windowsConfiguration: {
          enableAutomaticUpdates: bool
        }
      }
    }
    displayName: 'string'
    interNodeCommunication: 'string'
    maxTasksPerNode: int
    metadata: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    networkConfiguration: {
      endpointConfiguration: {
        inboundNatPools: [
          {
            backendPort: int
            frontendPortRangeEnd: int
            frontendPortRangeStart: int
            name: 'string'
            networkSecurityGroupRules: [
              {
                access: 'string'
                priority: int
                sourceAddressPrefix: 'string'
              }
            ]
            protocol: 'string'
          }
        ]
      }
      subnetId: 'string'
    }
    scaleSettings: {
      autoScale: {
        evaluationInterval: 'string'
        formula: 'string'
      }
      fixedScale: {
        nodeDeallocationOption: 'string'
        resizeTimeout: 'string'
        targetDedicatedNodes: int
        targetLowPriorityNodes: int
      }
    }
    startTask: {
      commandLine: 'string'
      environmentSettings: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      maxTaskRetryCount: int
      resourceFiles: [
        {
          blobSource: 'string'
          fileMode: 'string'
          filePath: 'string'
        }
      ]
      userIdentity: {
        autoUser: {
          elevationLevel: 'string'
          scope: 'string'
        }
        userName: 'string'
      }
      waitForSuccess: bool
    }
    taskSchedulingPolicy: {
      nodeFillType: 'string'
    }
    userAccounts: [
      {
        elevationLevel: 'string'
        linuxUserConfiguration: {
          gid: int
          sshPrivateKey: 'string'
          uid: int
        }
        name: 'string'
        password: 'string'
      }
    ]
    vmSize: 'string'
  }
}

Eigenschaftswerte

ApplicationPackageReference

Name Beschreibung Wert
id Die ID des zu installierenden Anwendungspakets. Dies muss sich innerhalb desselben Batchkontos wie der Pool befinden. Dies kann entweder ein Verweis auf eine bestimmte Version oder die Standardversion sein, falls vorhanden. Zeichenfolge (erforderlich)
Version Wenn dies nicht angegeben wird und für diese Anwendung keine Standardversion angegeben wird, schlägt die Anforderung mit dem Fehlercode InvalidApplicationPackageReferences fehl. Wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 409. Schnur

AutoScaleSettings

Name Beschreibung Wert
evaluationInterval Wenn dieser Wert nicht angegeben wird, beträgt der Standardwert 15 Minuten (PT15M). Schnur
Formel Eine Formel für die gewünschte Anzahl von Computeknoten im Pool. Zeichenfolge (erforderlich)

AutoUserSpecification

Name Beschreibung Wert
elevationLevel nonAdmin – Der automatische Benutzer ist ein Standardbenutzer ohne erhöhten Zugriff. admin – Der automatische Benutzer ist ein Benutzer mit erhöhtem Zugriff und arbeitet mit vollständigen Administratorberechtigungen. Der Standardwert ist "nonAdmin". "Administrator"
'NonAdmin'
Umfang pool – gibt an, dass die Aufgabe als allgemeines automatisches Benutzerkonto ausgeführt wird, das auf jedem Knoten in einem Pool erstellt wird. task - gibt an, dass der Dienst einen neuen Benutzer für die Aufgabe erstellen soll. Der Standardwert ist "Task". "Pool"
"Vorgang"

CertificateReference

Name Beschreibung Wert
id Die vollqualifizierte ID des Zertifikats, das im Pool installiert werden soll. Dies muss sich innerhalb desselben Batchkontos wie der Pool befinden. Zeichenfolge (erforderlich)
storeLocation Der Standardwert ist currentUser. Diese Eigenschaft gilt nur für Pools, die mit Windows-Knoten konfiguriert sind (d. a. erstellt mit cloudServiceConfiguration oder mit virtualMachineConfiguration mithilfe eines Windows-Imageverweises). Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis der Aufgabe gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR der Aufgabe bereitgestellt wird, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von "remoteUser" wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers (z. B. /home/{user-name}/certs) erstellt und Zertifikate in diesem Verzeichnis platziert. 'CurrentUser'
"LocalMachine"
storeName Diese Eigenschaft gilt nur für Pools, die mit Windows-Knoten konfiguriert sind (d. a. erstellt mit cloudServiceConfiguration oder mit virtualMachineConfiguration mithilfe eines Windows-Imageverweises). Allgemeine Store-Namen sind: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, but any custom store name can also be used. Der Standardwert ist "Mein". Schnur
Sichtbarkeit Werte sind:

starttask – Das Benutzerkonto, unter dem die Startaufgabe ausgeführt wird.
task – Die Konten, unter denen Auftragsaufgaben ausgeführt werden.
remoteuser – Die Konten, unter denen Benutzer remote auf den Knoten zugreifen.

Sie können in dieser Sammlung mehr als eine Sichtbarkeit angeben. Der Standardwert ist alle Konten.
Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'RemoteUser'
"StartTask"
"Vorgang"

CloudServiceConfiguration

Name Beschreibung Wert
currentOSVersion Dies kann sich von targetOSVersion unterscheiden, wenn der Poolstatus "Upgrade" lautet. In diesem Fall befinden sich einige virtuelle Computer möglicherweise auf der targetOSVersion und einige befinden sich möglicherweise während des Upgradevorgangs auf dem currentOSVersion.In this case some virtual machines may be on the targetOSVersion and some may be on the currentOSVersion during the upgrade process. Sobald alle virtuellen Computer aktualisiert wurden, wird currentOSVersion so aktualisiert, dass sie mit targetOSVersion identisch ist. Schnur
osFamily Mögliche Werte sind: 2 – Betriebssystemfamilie 2, entspricht Windows Server 2008 R2 SP1. 3 – Betriebssystemfamilie 3, entspricht Windows Server 2012. 4 – Betriebssystemfamilie 4, entspricht Windows Server 2012 R2. 5 – Betriebssystemfamilie 5, entspricht Windows Server 2016. Weitere Informationen finden Sie unter Azure Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). Zeichenfolge (erforderlich)
targetOSVersion Der Standardwert ist * und gibt die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie an. Schnur

DataDisk

Name Beschreibung Wert
Caching Werte sind:

none – Der Cachemodus für den Datenträger ist nicht aktiviert.
readOnly – Der Cachemodus für den Datenträger ist schreibgeschützt.
readWrite – Der Cachemodus für den Datenträger ist lese- und schreibgeschützt.

Der Standardwert für die Zwischenspeicherung ist keine. Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
'None'
'ReadOnly'
'ReadWrite'
diskSizeGB Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Datenträgers. int (erforderlich)
lun Die Lun wird verwendet, um jeden Datenträger eindeutig zu identifizieren. Wenn sie mehrere Datenträger anfügen, sollte jeder eine unterschiedliche Lun aufweisen. int (erforderlich)
storageAccountType Wenn nicht angegeben, lautet der Standardwert "Standard_LRS". Werte sind:

Standard_LRS – Der Datenträger sollte standardmäßigen lokal redundanten Speicher verwenden.
Premium_LRS – Der Datenträger sollte einen lokal redundanten Premiumspeicher verwenden.
"Premium_LRS"
"Standard_LRS"

DeploymentConfiguration

Name Beschreibung Wert
cloudServiceConfiguration Diese Eigenschaft und virtualMachineConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. Diese Eigenschaft kann nicht angegeben werden, wenn das Batchkonto mit der poolAllocationMode-Eigenschaft erstellt wurde, die auf "UserSubscription" festgelegt ist. CloudServiceConfiguration-
virtualMachineConfiguration Diese Eigenschaft und cloudServiceConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. VirtualMachineConfiguration

EnvironmentSetting

Name Beschreibung Wert
Name Der Name der Umgebungsvariable. Zeichenfolge (erforderlich)
Wert Der Wert der Umgebungsvariable. Schnur

FixedScaleSettings

Name Beschreibung Wert
nodeDeallocationOption Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "Requeue". 'Requeue'
"RetainedData"
"TaskCompletion"
"Beenden"
resizeTimeout Der Standardwert beträgt 15 Minuten. Timeoutwerte verwenden das ISO 8601-Format. Verwenden Sie z. B. PT10M für 10 Minuten. Der Mindestwert beträgt 5 Minuten. Wenn Sie einen Wert kleiner als 5 Minuten angeben, lehnt der Batchdienst die Anforderung mit einem Fehler ab; wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung). Schnur
targetDedicatedNodes Mindestens einer von targetDedicatedNodes muss targetLowPriority-Knoten festgelegt werden. Int
targetLowPriorityNodes Mindestens einer von targetDedicatedNodes muss targetLowPriority-Knoten festgelegt werden. Int

ImageReference

Name Beschreibung Wert
id Diese Eigenschaft schließt sich gegenseitig mit anderen Eigenschaften aus. Das Image des virtuellen Computers muss sich in derselben Region und demselben Abonnement wie das Azure Batch-Konto befinden. Informationen zu den Firewalleinstellungen für den Batchknoten-Agent für die Kommunikation mit dem Batchdienst finden Sie unter "/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration". Schnur
Angebot Beispiel: UbuntuServer oder WindowsServer. Schnur
Verlag Beispiel: Canonical oder MicrosoftWindowsServer. Schnur
Sku Beispiel: 14.04.0-LTS oder 2012-R2-Datacenter. Schnur
Version Ein Wert von "latest" kann angegeben werden, um die neueste Version eines Bilds auszuwählen. Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "latest". Schnur

InboundNatPool

Name Beschreibung Wert
backPort Dies muss innerhalb eines Batchpools eindeutig sein. Zulässige Werte liegen zwischen 1 und 65535, mit Ausnahme von 22, 3389, 29876 und 29877, da diese reserviert sind. Wenn reservierte Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. int (erforderlich)
frontendPortRangeEnd Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die vom Batchdienst reserviert sind. Alle Bereiche innerhalb eines Pools müssen eindeutig sein und können nicht überlappen. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. int (erforderlich)
frontendPortRangeStart Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die reserviert sind. Alle Bereiche innerhalb eines Pools müssen eindeutig sein und können nicht überlappen. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. int (erforderlich)
Name Der Name muss innerhalb eines Batchpools eindeutig sein, kann Buchstaben, Zahlen, Unterstriche, Punkte und Bindestriche enthalten. Namen müssen mit einem Buchstaben oder einer Zahl beginnen, müssen mit einem Buchstaben, einer Zahl oder einem Unterstrich enden und dürfen 77 Zeichen nicht überschreiten. Wenn ungültige Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. Zeichenfolge (erforderlich)
networkSecurityGroupRules Die maximale Anzahl von Regeln, die für alle Endpunkte in einem Batchpool angegeben werden können, beträgt 25. Wenn keine Regeln für Netzwerksicherheitsgruppen angegeben sind, wird eine Standardregel erstellt, um den eingehenden Zugriff auf den angegebenen Back-EndPort zuzulassen. Wenn die maximale Anzahl von Netzwerksicherheitsgruppenregeln überschritten wird, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. NetworkSecurityGroupRule[]
Protokoll Das Protokoll des Endpunkts. "TCP"
"UDP" (erforderlich)

LinuxUserConfiguration

Name Beschreibung Wert
gid Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird das Gid ausgewählt. Int
sshPrivateKey Der private Schlüssel darf nicht kennwortgeschützter Schlüssel sein. Der private Schlüssel wird verwendet, um die asymmetrische schlüsselbasierte Authentifizierung für SSH zwischen Knoten in einem Linux-Pool automatisch zu konfigurieren, wenn die Eigenschaft enableInterNodeCommunication des Pools wahr ist (wird ignoriert, wenn enableInterNodeCommunication false ist). Dazu wird das Schlüsselpaar in das SSH-Verzeichnis des Benutzers eingefügt. Wenn nicht angegeben, wird kennwortloses SSH nicht zwischen Knoten konfiguriert (es erfolgt keine Änderung des SSH-Verzeichnisses des Benutzers). Schnur
uid Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird die UID ausgewählt. Int

MetadataItem

Name Beschreibung Wert
Name Der Name des Metadatenelements. Zeichenfolge (erforderlich)
Wert Der Wert des Metadatenelements. Zeichenfolge (erforderlich)

Microsoft.Batch/batchAccounts/pools

Name Beschreibung Wert
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 64
Pattern = ^[a-zA-Z0-9_-]+$ (erforderlich)
Elternteil In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für Ressource des Typs: batchAccounts
Eigenschaften Die dem Pool zugeordneten Eigenschaften. PoolProperties-

NetworkConfiguration

Name Beschreibung Wert
endpointConfiguration Die Poolendpunktkonfiguration wird nur für Pools mit der virtualMachineConfiguration-Eigenschaft unterstützt. PoolEndpointConfiguration
subnetz-ID Das virtuelle Netzwerk muss sich in derselben Region und im gleichen Abonnement wie das Azure Batch-Konto befinden. Das angegebene Subnetz sollte über genügend freie IP-Adressen verfügen, um die Anzahl der Knoten im Pool aufzunehmen. Wenn das Subnetz nicht über genügend freie IP-Adressen verfügt, weist der Pool teilweise Computeknoten zu, und es tritt ein Fehler bei der Größenänderung auf. Der Dienstprinzipal "MicrosoftAzureBatch" muss über die Rolle "Classic Virtual Machine Contributor" Role-Based Access Control (RBAC) für das angegebene VNet verfügen. Das angegebene Subnetz muss zulassen, dass die Kommunikation vom Azure Batch-Dienst Vorgänge auf den Computeknoten planen kann. Dies kann überprüft werden, indem überprüft wird, ob das angegebene VNet über alle zugehörigen Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt. Wenn die Kommunikation mit den Computeknoten im angegebenen Subnetz von einer NSG verweigert wird, legt der Batchdienst den Status der Computeknoten auf unbrauchbar fest. Für Pools, die über virtualMachineConfiguration erstellt werden, muss das Batchkonto über poolAllocationMode userSubscription verfügen, um ein VNet verwenden zu können. Wenn das angegebene VNet über eine zugeordnete Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt, müssen einige reservierte Systemports für eingehende Kommunikation aktiviert werden. Aktivieren Sie für Pools, die mit einer Konfiguration für virtuelle Computer erstellt wurden, ports 29876 und 29877 sowie Port 22 für Linux und Port 3389 für Windows. Aktivieren Sie für Pools, die mit einer Clouddienstkonfiguration erstellt wurden, ports 10100, 20100 und 30100. Aktivieren Sie auch ausgehende Verbindungen mit Azure Storage auf Port 443. Weitere Informationen finden Sie unter :/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration Schnur

NetworkSecurityGroupRule

Name Beschreibung Wert
Zugang Die Aktion, die für eine angegebene IP-Adresse, einen Subnetzbereich oder ein Bestimmtes Tag ausgeführt werden soll. "Zulassen"
"Verweigern" (erforderlich)
Priorität Prioritäten innerhalb eines Pools müssen eindeutig sein und in der Reihenfolge der Priorität ausgewertet werden. Je niedriger die Zahl ist, desto höher ist die Priorität. Regeln können beispielsweise mit den Bestellnummern 150, 250 und 350 angegeben werden. Die Regel mit der Bestellnummer 150 hat Vorrang vor der Regel mit einer Reihenfolge von 250. Zulässige Prioritäten sind 150 bis 3500. Wenn reservierte oder doppelte Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. int (erforderlich)
sourceAddressPrefix Gültige Werte sind eine einzelne IP-Adresse (d. h. 10.10.10.10), IP-Subnetz (d. h. 192.168.1.0/24), Standardtag oder * (für alle Adressen). Wenn andere Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. Zeichenfolge (erforderlich)

OSDisk

Name Beschreibung Wert
Caching Der Standardwert ist keine. 'None'
'ReadOnly'
'ReadWrite'

PoolEndpointConfiguration

Name Beschreibung Wert
inboundNatPools Die maximale Anzahl eingehender NAT-Pools pro Batchpool beträgt 5. Wenn die maximale Anzahl eingehender NAT-Pools überschritten wird, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. InboundNatPool-[] (erforderlich)

PoolProperties

Name Beschreibung Wert
applicationLicenses Die Liste der Anwendungslizenzen muss eine Teilmenge der verfügbaren Batchdienstanwendungslizenzen sein. Wenn eine Lizenz angefordert wird, die nicht unterstützt wird, schlägt die Poolerstellung fehl. string[]
applicationPackages Änderungen an Anwendungspaketen wirken sich auf alle neuen Computeknoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages neu erstellt werden. ApplicationPackageReference[]
Atteste Für Windows-Computeknoten installiert der Batchdienst die Zertifikate im angegebenen Zertifikatspeicher und -speicherort. Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis der Aufgabe gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR der Aufgabe bereitgestellt wird, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von "remoteUser" wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers (z. B. /home/{user-name}/certs) erstellt und Zertifikate in diesem Verzeichnis platziert. CertificateReference-[]
deploymentConfiguration Die Verwendung von CloudServiceConfiguration gibt an, dass die Knoten mithilfe von Azure Cloud Services (PaaS) erstellt werden sollen, während VirtualMachineConfiguration Azure Virtual Machines (IaaS) verwendet. DeploymentConfiguration-
displayName Der Anzeigename muss nicht eindeutig sein und kann alle Unicode-Zeichen bis zu einer maximalen Länge von 1024 enthalten. Schnur
interNodeCommunication Dadurch werden Einschränkungen auferlegt, denen dem Pool Knoten zugewiesen werden können. Durch Aktivieren dieses Werts kann die Wahrscheinlichkeit verringert werden, dass die angeforderte Anzahl von Knoten im Pool zugewiesen werden soll. Wenn nicht angegeben, wird dieser Wert standardmäßig auf "Deaktiviert" festgelegt. "Deaktiviert"
"Aktiviert"
maxTasksPerNode Die maximale Anzahl von Aufgaben, die gleichzeitig auf einem einzelnen Computeknoten im Pool ausgeführt werden können. Int
Metadaten Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen. MetadataItem-[]
networkConfiguration Die Netzwerkkonfiguration für einen Pool. NetworkConfiguration-
scaleSettings Definiert die gewünschte Größe des Pools. Dies kann entweder "fixedScale" sein, bei dem die angeforderten targetDedicatedNodes angegeben sind, oder 'autoScale', die eine Formel definiert, die regelmäßig neu ausgewertet wird. Wenn diese Eigenschaft nicht angegeben ist, hat der Pool eine feste Skalierung mit 0 targetDedicatedNodes. ScaleSettings-
startTask In einem PATCH-Vorgang (Update) kann diese Eigenschaft auf ein leeres Objekt festgelegt werden, um die Startaufgabe aus dem Pool zu entfernen. StartTask-
taskSchedulingPolicy Gibt an, wie Aufgaben über Computeknoten verteilt werden sollen. TaskSchedulingPolicy-
userAccounts Die Liste der Benutzerkonten, die auf jedem Knoten im Pool erstellt werden sollen. UserAccount[]
vmSize Informationen zu verfügbaren Größen virtueller Computer für Cloud Services-Pools (mit CloudServiceConfiguration erstellte Pools) finden Sie unter Größen für Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch unterstützt alle VM-Größen der Clouddienste mit Ausnahme von ExtraSmall. Informationen zu verfügbaren VM-Größen für Pools mit Images vom Virtual Machines Marketplace (Pools, die mit virtualMachineConfiguration erstellt wurden) finden Sie unter Größen für virtuelle Computer (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) oder Größen für virtuelle Computer (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch unterstützt alle Azure VM-Größen außer STANDARD_A0 und denen mit Premiumspeicher (STANDARD_GS, STANDARD_DS und STANDARD_DSV2 Serie). Schnur

ResourceFile

Name Beschreibung Wert
blobSource Diese URL muss mithilfe des anonymen Zugriffs lesbar sein; d. h. der Batchdienst stellt beim Herunterladen des Blobs keine Anmeldeinformationen bereit. Es gibt zwei Möglichkeiten, eine solche URL für ein Blob im Azure-Speicher abzurufen: Schließen Sie eine SAS (Shared Access Signature) ein, die Leseberechtigungen für das Blob gewährt, oder legen Sie die ACL für das Blob oder dessen Container fest, um den öffentlichen Zugriff zu ermöglichen. Zeichenfolge (erforderlich)
fileMode Diese Eigenschaft gilt nur für Dateien, die auf Linux-Computeknoten heruntergeladen werden. Sie wird ignoriert, wenn sie für eine resourceFile angegeben wird, die auf einen Windows-Knoten heruntergeladen wird. Wenn diese Eigenschaft für einen Linux-Knoten nicht angegeben ist, wird auf die Datei ein Standardwert von 0770 angewendet. Schnur
filePath Der Speicherort auf dem Computeknoten, in den die Datei heruntergeladen werden soll, relativ zum Arbeitsverzeichnis der Aufgabe. Zeichenfolge (erforderlich)

ScaleSettings

Name Beschreibung Wert
AutoScale Diese Eigenschaft und fixedScale schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. AutoScaleSettings-
fixedScale Diese Eigenschaft und autoScale schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. FixedScaleSettings-

StartTask

Name Beschreibung Wert
commandLine Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux. Erforderlich, wenn andere Eigenschaften des startTask angegeben werden. Schnur
environmentSettings Eine Liste der Umgebungsvariableneinstellungen für die Startaufgabe. EnvironmentSetting[]
maxTaskRetryCount Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Beachten Sie, dass dieser Wert speziell die Anzahl der Wiederholungen steuert. Der Batchdienst versucht die Aufgabe einmal und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn beispielsweise die maximale Wiederholungsanzahl 3 ist, versucht Batch den Vorgang bis zu 4 Mal (ein erster Versuch und 3 Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, führt der Batchdienst den Vorgang nicht erneut aus. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst den Vorgang ohne Beschränkung. Int
resourceFiles Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. ResourceFile-[]
userIdentity Wenn sie weggelassen wird, wird die Aufgabe als nicht administrativer Benutzer ausgeführt, der für die Aufgabe eindeutig ist. UserIdentity-
waitForSuccess Wenn true und die Startaufgabe auf einem Computeknoten fehlschlägt, wiederholt der Batchdienst die Startaufgabe bis zur maximalen Wiederholungsanzahl (maxTaskRetryCount). Wenn der Vorgang nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Computeknoten nicht mehr verwendbar, und er plant keine Vorgänge. Diese Bedingung kann über den Knotenstatus und das Planungsfehlerdetails erkannt werden. Wenn false, wartet der Batchdienst nicht, bis die Startaufgabe abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung auf dem Computeknoten beginnen, während die Startaufgabe noch ausgeführt wird. und auch wenn der Startvorgang fehlschlägt, werden neue Vorgänge weiterhin auf dem Knoten geplant. Der Standardwert ist "false". Bool

TaskSchedulingPolicy

Name Beschreibung Wert
nodeFillType Wie Aufgaben über Computeknoten verteilt werden sollen. "Pack"
"Spread" (erforderlich)

UserAccount

Name Beschreibung Wert
elevationLevel nonAdmin – Der automatische Benutzer ist ein Standardbenutzer ohne erhöhten Zugriff. admin – Der automatische Benutzer ist ein Benutzer mit erhöhtem Zugriff und arbeitet mit vollständigen Administratorberechtigungen. Der Standardwert ist "nonAdmin". "Administrator"
'NonAdmin'
linuxUserConfiguration Diese Eigenschaft wird ignoriert, wenn sie in einem Windows-Pool angegeben ist. Wenn nicht angegeben, wird der Benutzer mit den Standardoptionen erstellt. LinuxUserConfiguration-
Name Der Name des Benutzerkontos. Zeichenfolge (erforderlich)
Passwort Das Kennwort für das Benutzerkonto. Zeichenfolge (erforderlich)

UserIdentity

Name Beschreibung Wert
autoUser Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben. AutoUserSpecification-
Nutzername Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben. Schnur

VirtualMachineConfiguration

Name Beschreibung Wert
dataDisks Diese Eigenschaft muss angegeben werden, wenn die Computeknoten im Pool über leere Datenträger verfügen müssen, die an sie angefügt sind. DataDisk-[]
imageReference Ein Verweis auf ein Azure Virtual Machines Marketplace-Image oder die Azure Image-Ressource eines benutzerdefinierten virtuellen Computers. Informationen zum Abrufen der Liste aller imageReferences, die von Azure Batch überprüft wurden, finden Sie im Vorgang "Auflisten unterstützter Knoten-Agent-SKUs". ImageReference- (erforderlich)
licenseType Dies gilt nur für Images, die das Windows-Betriebssystem enthalten, und sollte nur verwendet werden, wenn Sie gültige lokale Lizenzen für die Knoten halten, die bereitgestellt werden. Ohne Angabe wird kein lokaler Lizenzierungsrabatt angewendet. Werte sind:

Windows_Server – Die lokale Lizenz gilt für Windows Server.
Windows_Client – Die lokale Lizenz ist für Windows Client.
Schnur
nodeAgentSkuId Der Batchknoten-Agent ist ein Programm, das auf jedem Knoten im Pool ausgeführt wird und die Befehls- und Steuerungsschnittstelle zwischen dem Knoten und dem Batchdienst bereitstellt. Es gibt unterschiedliche Implementierungen des Knoten-Agents, die als SKUs bezeichnet werden, für verschiedene Betriebssysteme. Sie müssen eine Knoten-Agent-SKU angeben, die dem ausgewählten Imageverweis entspricht. Informationen zum Abrufen der Liste der unterstützten Knoten-Agent-SKUs sowie deren Liste der überprüften Bildverweise finden Sie im Vorgang "Auflisten unterstützter Knoten-Agent-SKUs". Zeichenfolge (erforderlich)
osDisk Einstellungen für den Betriebssystemdatenträger des virtuellen Computers. OSDisk-
windowsConfiguration Diese Eigenschaft darf nicht angegeben werden, wenn das imageReference ein Linux-Betriebssystemimage angibt. WindowsConfiguration-

WindowsConfiguration

Name Beschreibung Wert
enableAutomaticUpdates Wenn dieser Wert nicht angegeben wird, ist der Standardwert "true". Bool

Schnellstartbeispiele

Die folgenden Schnellstartbeispiele stellen diesen Ressourcentyp bereit.

Bicep-Datei Beschreibung
Azure Batchpool ohne öffentliche IP-Adressen Diese Vorlage erstellt einen vereinfachten Azure Batch-Knotenkommunikationspool ohne öffentliche IP-Adressen.

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "batchAccounts/pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Batch/batchAccounts/pools-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.Batch/batchAccounts/pools",
  "apiVersion": "2017-09-01",
  "name": "string",
  "properties": {
    "applicationLicenses": [ "string" ],
    "applicationPackages": [
      {
        "id": "string",
        "version": "string"
      }
    ],
    "certificates": [
      {
        "id": "string",
        "storeLocation": "string",
        "storeName": "string",
        "visibility": [ "string" ]
      }
    ],
    "deploymentConfiguration": {
      "cloudServiceConfiguration": {
        "currentOSVersion": "string",
        "osFamily": "string",
        "targetOSVersion": "string"
      },
      "virtualMachineConfiguration": {
        "dataDisks": [
          {
            "caching": "string",
            "diskSizeGB": "int",
            "lun": "int",
            "storageAccountType": "string"
          }
        ],
        "imageReference": {
          "id": "string",
          "offer": "string",
          "publisher": "string",
          "sku": "string",
          "version": "string"
        },
        "licenseType": "string",
        "nodeAgentSkuId": "string",
        "osDisk": {
          "caching": "string"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": "bool"
        }
      }
    },
    "displayName": "string",
    "interNodeCommunication": "string",
    "maxTasksPerNode": "int",
    "metadata": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "networkConfiguration": {
      "endpointConfiguration": {
        "inboundNatPools": [
          {
            "backendPort": "int",
            "frontendPortRangeEnd": "int",
            "frontendPortRangeStart": "int",
            "name": "string",
            "networkSecurityGroupRules": [
              {
                "access": "string",
                "priority": "int",
                "sourceAddressPrefix": "string"
              }
            ],
            "protocol": "string"
          }
        ]
      },
      "subnetId": "string"
    },
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "string",
        "formula": "string"
      },
      "fixedScale": {
        "nodeDeallocationOption": "string",
        "resizeTimeout": "string",
        "targetDedicatedNodes": "int",
        "targetLowPriorityNodes": "int"
      }
    },
    "startTask": {
      "commandLine": "string",
      "environmentSettings": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "maxTaskRetryCount": "int",
      "resourceFiles": [
        {
          "blobSource": "string",
          "fileMode": "string",
          "filePath": "string"
        }
      ],
      "userIdentity": {
        "autoUser": {
          "elevationLevel": "string",
          "scope": "string"
        },
        "userName": "string"
      },
      "waitForSuccess": "bool"
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "string"
    },
    "userAccounts": [
      {
        "elevationLevel": "string",
        "linuxUserConfiguration": {
          "gid": "int",
          "sshPrivateKey": "string",
          "uid": "int"
        },
        "name": "string",
        "password": "string"
      }
    ],
    "vmSize": "string"
  }
}

Eigenschaftswerte

ApplicationPackageReference

Name Beschreibung Wert
id Die ID des zu installierenden Anwendungspakets. Dies muss sich innerhalb desselben Batchkontos wie der Pool befinden. Dies kann entweder ein Verweis auf eine bestimmte Version oder die Standardversion sein, falls vorhanden. Zeichenfolge (erforderlich)
Version Wenn dies nicht angegeben wird und für diese Anwendung keine Standardversion angegeben wird, schlägt die Anforderung mit dem Fehlercode InvalidApplicationPackageReferences fehl. Wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 409. Schnur

AutoScaleSettings

Name Beschreibung Wert
evaluationInterval Wenn dieser Wert nicht angegeben wird, beträgt der Standardwert 15 Minuten (PT15M). Schnur
Formel Eine Formel für die gewünschte Anzahl von Computeknoten im Pool. Zeichenfolge (erforderlich)

AutoUserSpecification

Name Beschreibung Wert
elevationLevel nonAdmin – Der automatische Benutzer ist ein Standardbenutzer ohne erhöhten Zugriff. admin – Der automatische Benutzer ist ein Benutzer mit erhöhtem Zugriff und arbeitet mit vollständigen Administratorberechtigungen. Der Standardwert ist "nonAdmin". "Administrator"
'NonAdmin'
Umfang pool – gibt an, dass die Aufgabe als allgemeines automatisches Benutzerkonto ausgeführt wird, das auf jedem Knoten in einem Pool erstellt wird. task - gibt an, dass der Dienst einen neuen Benutzer für die Aufgabe erstellen soll. Der Standardwert ist "Task". "Pool"
"Vorgang"

CertificateReference

Name Beschreibung Wert
id Die vollqualifizierte ID des Zertifikats, das im Pool installiert werden soll. Dies muss sich innerhalb desselben Batchkontos wie der Pool befinden. Zeichenfolge (erforderlich)
storeLocation Der Standardwert ist currentUser. Diese Eigenschaft gilt nur für Pools, die mit Windows-Knoten konfiguriert sind (d. a. erstellt mit cloudServiceConfiguration oder mit virtualMachineConfiguration mithilfe eines Windows-Imageverweises). Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis der Aufgabe gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR der Aufgabe bereitgestellt wird, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von "remoteUser" wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers (z. B. /home/{user-name}/certs) erstellt und Zertifikate in diesem Verzeichnis platziert. 'CurrentUser'
"LocalMachine"
storeName Diese Eigenschaft gilt nur für Pools, die mit Windows-Knoten konfiguriert sind (d. a. erstellt mit cloudServiceConfiguration oder mit virtualMachineConfiguration mithilfe eines Windows-Imageverweises). Allgemeine Store-Namen sind: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, but any custom store name can also be used. Der Standardwert ist "Mein". Schnur
Sichtbarkeit Werte sind:

starttask – Das Benutzerkonto, unter dem die Startaufgabe ausgeführt wird.
task – Die Konten, unter denen Auftragsaufgaben ausgeführt werden.
remoteuser – Die Konten, unter denen Benutzer remote auf den Knoten zugreifen.

Sie können in dieser Sammlung mehr als eine Sichtbarkeit angeben. Der Standardwert ist alle Konten.
Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'RemoteUser'
"StartTask"
"Vorgang"

CloudServiceConfiguration

Name Beschreibung Wert
currentOSVersion Dies kann sich von targetOSVersion unterscheiden, wenn der Poolstatus "Upgrade" lautet. In diesem Fall befinden sich einige virtuelle Computer möglicherweise auf der targetOSVersion und einige befinden sich möglicherweise während des Upgradevorgangs auf dem currentOSVersion.In this case some virtual machines may be on the targetOSVersion and some may be on the currentOSVersion during the upgrade process. Sobald alle virtuellen Computer aktualisiert wurden, wird currentOSVersion so aktualisiert, dass sie mit targetOSVersion identisch ist. Schnur
osFamily Mögliche Werte sind: 2 – Betriebssystemfamilie 2, entspricht Windows Server 2008 R2 SP1. 3 – Betriebssystemfamilie 3, entspricht Windows Server 2012. 4 – Betriebssystemfamilie 4, entspricht Windows Server 2012 R2. 5 – Betriebssystemfamilie 5, entspricht Windows Server 2016. Weitere Informationen finden Sie unter Azure Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). Zeichenfolge (erforderlich)
targetOSVersion Der Standardwert ist * und gibt die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie an. Schnur

DataDisk

Name Beschreibung Wert
Caching Werte sind:

none – Der Cachemodus für den Datenträger ist nicht aktiviert.
readOnly – Der Cachemodus für den Datenträger ist schreibgeschützt.
readWrite – Der Cachemodus für den Datenträger ist lese- und schreibgeschützt.

Der Standardwert für die Zwischenspeicherung ist keine. Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
'None'
'ReadOnly'
'ReadWrite'
diskSizeGB Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Datenträgers. int (erforderlich)
lun Die Lun wird verwendet, um jeden Datenträger eindeutig zu identifizieren. Wenn sie mehrere Datenträger anfügen, sollte jeder eine unterschiedliche Lun aufweisen. int (erforderlich)
storageAccountType Wenn nicht angegeben, lautet der Standardwert "Standard_LRS". Werte sind:

Standard_LRS – Der Datenträger sollte standardmäßigen lokal redundanten Speicher verwenden.
Premium_LRS – Der Datenträger sollte einen lokal redundanten Premiumspeicher verwenden.
"Premium_LRS"
"Standard_LRS"

DeploymentConfiguration

Name Beschreibung Wert
cloudServiceConfiguration Diese Eigenschaft und virtualMachineConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. Diese Eigenschaft kann nicht angegeben werden, wenn das Batchkonto mit der poolAllocationMode-Eigenschaft erstellt wurde, die auf "UserSubscription" festgelegt ist. CloudServiceConfiguration-
virtualMachineConfiguration Diese Eigenschaft und cloudServiceConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. VirtualMachineConfiguration

EnvironmentSetting

Name Beschreibung Wert
Name Der Name der Umgebungsvariable. Zeichenfolge (erforderlich)
Wert Der Wert der Umgebungsvariable. Schnur

FixedScaleSettings

Name Beschreibung Wert
nodeDeallocationOption Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "Requeue". 'Requeue'
"RetainedData"
"TaskCompletion"
"Beenden"
resizeTimeout Der Standardwert beträgt 15 Minuten. Timeoutwerte verwenden das ISO 8601-Format. Verwenden Sie z. B. PT10M für 10 Minuten. Der Mindestwert beträgt 5 Minuten. Wenn Sie einen Wert kleiner als 5 Minuten angeben, lehnt der Batchdienst die Anforderung mit einem Fehler ab; wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung). Schnur
targetDedicatedNodes Mindestens einer von targetDedicatedNodes muss targetLowPriority-Knoten festgelegt werden. Int
targetLowPriorityNodes Mindestens einer von targetDedicatedNodes muss targetLowPriority-Knoten festgelegt werden. Int

ImageReference

Name Beschreibung Wert
id Diese Eigenschaft schließt sich gegenseitig mit anderen Eigenschaften aus. Das Image des virtuellen Computers muss sich in derselben Region und demselben Abonnement wie das Azure Batch-Konto befinden. Informationen zu den Firewalleinstellungen für den Batchknoten-Agent für die Kommunikation mit dem Batchdienst finden Sie unter "/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration". Schnur
Angebot Beispiel: UbuntuServer oder WindowsServer. Schnur
Verlag Beispiel: Canonical oder MicrosoftWindowsServer. Schnur
Sku Beispiel: 14.04.0-LTS oder 2012-R2-Datacenter. Schnur
Version Ein Wert von "latest" kann angegeben werden, um die neueste Version eines Bilds auszuwählen. Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "latest". Schnur

InboundNatPool

Name Beschreibung Wert
backPort Dies muss innerhalb eines Batchpools eindeutig sein. Zulässige Werte liegen zwischen 1 und 65535, mit Ausnahme von 22, 3389, 29876 und 29877, da diese reserviert sind. Wenn reservierte Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. int (erforderlich)
frontendPortRangeEnd Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die vom Batchdienst reserviert sind. Alle Bereiche innerhalb eines Pools müssen eindeutig sein und können nicht überlappen. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. int (erforderlich)
frontendPortRangeStart Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die reserviert sind. Alle Bereiche innerhalb eines Pools müssen eindeutig sein und können nicht überlappen. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. int (erforderlich)
Name Der Name muss innerhalb eines Batchpools eindeutig sein, kann Buchstaben, Zahlen, Unterstriche, Punkte und Bindestriche enthalten. Namen müssen mit einem Buchstaben oder einer Zahl beginnen, müssen mit einem Buchstaben, einer Zahl oder einem Unterstrich enden und dürfen 77 Zeichen nicht überschreiten. Wenn ungültige Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. Zeichenfolge (erforderlich)
networkSecurityGroupRules Die maximale Anzahl von Regeln, die für alle Endpunkte in einem Batchpool angegeben werden können, beträgt 25. Wenn keine Regeln für Netzwerksicherheitsgruppen angegeben sind, wird eine Standardregel erstellt, um den eingehenden Zugriff auf den angegebenen Back-EndPort zuzulassen. Wenn die maximale Anzahl von Netzwerksicherheitsgruppenregeln überschritten wird, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. NetworkSecurityGroupRule[]
Protokoll Das Protokoll des Endpunkts. "TCP"
"UDP" (erforderlich)

LinuxUserConfiguration

Name Beschreibung Wert
gid Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird das Gid ausgewählt. Int
sshPrivateKey Der private Schlüssel darf nicht kennwortgeschützter Schlüssel sein. Der private Schlüssel wird verwendet, um die asymmetrische schlüsselbasierte Authentifizierung für SSH zwischen Knoten in einem Linux-Pool automatisch zu konfigurieren, wenn die Eigenschaft enableInterNodeCommunication des Pools wahr ist (wird ignoriert, wenn enableInterNodeCommunication false ist). Dazu wird das Schlüsselpaar in das SSH-Verzeichnis des Benutzers eingefügt. Wenn nicht angegeben, wird kennwortloses SSH nicht zwischen Knoten konfiguriert (es erfolgt keine Änderung des SSH-Verzeichnisses des Benutzers). Schnur
uid Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird die UID ausgewählt. Int

MetadataItem

Name Beschreibung Wert
Name Der Name des Metadatenelements. Zeichenfolge (erforderlich)
Wert Der Wert des Metadatenelements. Zeichenfolge (erforderlich)

Microsoft.Batch/batchAccounts/pools

Name Beschreibung Wert
apiVersion Die API-Version '2017-09-01'
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 64
Pattern = ^[a-zA-Z0-9_-]+$ (erforderlich)
Eigenschaften Die dem Pool zugeordneten Eigenschaften. PoolProperties-
Art Der Ressourcentyp "Microsoft.Batch/batchAccounts/pools"

NetworkConfiguration

Name Beschreibung Wert
endpointConfiguration Die Poolendpunktkonfiguration wird nur für Pools mit der virtualMachineConfiguration-Eigenschaft unterstützt. PoolEndpointConfiguration
subnetz-ID Das virtuelle Netzwerk muss sich in derselben Region und im gleichen Abonnement wie das Azure Batch-Konto befinden. Das angegebene Subnetz sollte über genügend freie IP-Adressen verfügen, um die Anzahl der Knoten im Pool aufzunehmen. Wenn das Subnetz nicht über genügend freie IP-Adressen verfügt, weist der Pool teilweise Computeknoten zu, und es tritt ein Fehler bei der Größenänderung auf. Der Dienstprinzipal "MicrosoftAzureBatch" muss über die Rolle "Classic Virtual Machine Contributor" Role-Based Access Control (RBAC) für das angegebene VNet verfügen. Das angegebene Subnetz muss zulassen, dass die Kommunikation vom Azure Batch-Dienst Vorgänge auf den Computeknoten planen kann. Dies kann überprüft werden, indem überprüft wird, ob das angegebene VNet über alle zugehörigen Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt. Wenn die Kommunikation mit den Computeknoten im angegebenen Subnetz von einer NSG verweigert wird, legt der Batchdienst den Status der Computeknoten auf unbrauchbar fest. Für Pools, die über virtualMachineConfiguration erstellt werden, muss das Batchkonto über poolAllocationMode userSubscription verfügen, um ein VNet verwenden zu können. Wenn das angegebene VNet über eine zugeordnete Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt, müssen einige reservierte Systemports für eingehende Kommunikation aktiviert werden. Aktivieren Sie für Pools, die mit einer Konfiguration für virtuelle Computer erstellt wurden, ports 29876 und 29877 sowie Port 22 für Linux und Port 3389 für Windows. Aktivieren Sie für Pools, die mit einer Clouddienstkonfiguration erstellt wurden, ports 10100, 20100 und 30100. Aktivieren Sie auch ausgehende Verbindungen mit Azure Storage auf Port 443. Weitere Informationen finden Sie unter :/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration Schnur

NetworkSecurityGroupRule

Name Beschreibung Wert
Zugang Die Aktion, die für eine angegebene IP-Adresse, einen Subnetzbereich oder ein Bestimmtes Tag ausgeführt werden soll. "Zulassen"
"Verweigern" (erforderlich)
Priorität Prioritäten innerhalb eines Pools müssen eindeutig sein und in der Reihenfolge der Priorität ausgewertet werden. Je niedriger die Zahl ist, desto höher ist die Priorität. Regeln können beispielsweise mit den Bestellnummern 150, 250 und 350 angegeben werden. Die Regel mit der Bestellnummer 150 hat Vorrang vor der Regel mit einer Reihenfolge von 250. Zulässige Prioritäten sind 150 bis 3500. Wenn reservierte oder doppelte Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. int (erforderlich)
sourceAddressPrefix Gültige Werte sind eine einzelne IP-Adresse (d. h. 10.10.10.10), IP-Subnetz (d. h. 192.168.1.0/24), Standardtag oder * (für alle Adressen). Wenn andere Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. Zeichenfolge (erforderlich)

OSDisk

Name Beschreibung Wert
Caching Der Standardwert ist keine. 'None'
'ReadOnly'
'ReadWrite'

PoolEndpointConfiguration

Name Beschreibung Wert
inboundNatPools Die maximale Anzahl eingehender NAT-Pools pro Batchpool beträgt 5. Wenn die maximale Anzahl eingehender NAT-Pools überschritten wird, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. InboundNatPool-[] (erforderlich)

PoolProperties

Name Beschreibung Wert
applicationLicenses Die Liste der Anwendungslizenzen muss eine Teilmenge der verfügbaren Batchdienstanwendungslizenzen sein. Wenn eine Lizenz angefordert wird, die nicht unterstützt wird, schlägt die Poolerstellung fehl. string[]
applicationPackages Änderungen an Anwendungspaketen wirken sich auf alle neuen Computeknoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages neu erstellt werden. ApplicationPackageReference[]
Atteste Für Windows-Computeknoten installiert der Batchdienst die Zertifikate im angegebenen Zertifikatspeicher und -speicherort. Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis der Aufgabe gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR der Aufgabe bereitgestellt wird, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von "remoteUser" wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers (z. B. /home/{user-name}/certs) erstellt und Zertifikate in diesem Verzeichnis platziert. CertificateReference-[]
deploymentConfiguration Die Verwendung von CloudServiceConfiguration gibt an, dass die Knoten mithilfe von Azure Cloud Services (PaaS) erstellt werden sollen, während VirtualMachineConfiguration Azure Virtual Machines (IaaS) verwendet. DeploymentConfiguration-
displayName Der Anzeigename muss nicht eindeutig sein und kann alle Unicode-Zeichen bis zu einer maximalen Länge von 1024 enthalten. Schnur
interNodeCommunication Dadurch werden Einschränkungen auferlegt, denen dem Pool Knoten zugewiesen werden können. Durch Aktivieren dieses Werts kann die Wahrscheinlichkeit verringert werden, dass die angeforderte Anzahl von Knoten im Pool zugewiesen werden soll. Wenn nicht angegeben, wird dieser Wert standardmäßig auf "Deaktiviert" festgelegt. "Deaktiviert"
"Aktiviert"
maxTasksPerNode Die maximale Anzahl von Aufgaben, die gleichzeitig auf einem einzelnen Computeknoten im Pool ausgeführt werden können. Int
Metadaten Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen. MetadataItem-[]
networkConfiguration Die Netzwerkkonfiguration für einen Pool. NetworkConfiguration-
scaleSettings Definiert die gewünschte Größe des Pools. Dies kann entweder "fixedScale" sein, bei dem die angeforderten targetDedicatedNodes angegeben sind, oder 'autoScale', die eine Formel definiert, die regelmäßig neu ausgewertet wird. Wenn diese Eigenschaft nicht angegeben ist, hat der Pool eine feste Skalierung mit 0 targetDedicatedNodes. ScaleSettings-
startTask In einem PATCH-Vorgang (Update) kann diese Eigenschaft auf ein leeres Objekt festgelegt werden, um die Startaufgabe aus dem Pool zu entfernen. StartTask-
taskSchedulingPolicy Gibt an, wie Aufgaben über Computeknoten verteilt werden sollen. TaskSchedulingPolicy-
userAccounts Die Liste der Benutzerkonten, die auf jedem Knoten im Pool erstellt werden sollen. UserAccount[]
vmSize Informationen zu verfügbaren Größen virtueller Computer für Cloud Services-Pools (mit CloudServiceConfiguration erstellte Pools) finden Sie unter Größen für Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch unterstützt alle VM-Größen der Clouddienste mit Ausnahme von ExtraSmall. Informationen zu verfügbaren VM-Größen für Pools mit Images vom Virtual Machines Marketplace (Pools, die mit virtualMachineConfiguration erstellt wurden) finden Sie unter Größen für virtuelle Computer (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) oder Größen für virtuelle Computer (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch unterstützt alle Azure VM-Größen außer STANDARD_A0 und denen mit Premiumspeicher (STANDARD_GS, STANDARD_DS und STANDARD_DSV2 Serie). Schnur

ResourceFile

Name Beschreibung Wert
blobSource Diese URL muss mithilfe des anonymen Zugriffs lesbar sein; d. h. der Batchdienst stellt beim Herunterladen des Blobs keine Anmeldeinformationen bereit. Es gibt zwei Möglichkeiten, eine solche URL für ein Blob im Azure-Speicher abzurufen: Schließen Sie eine SAS (Shared Access Signature) ein, die Leseberechtigungen für das Blob gewährt, oder legen Sie die ACL für das Blob oder dessen Container fest, um den öffentlichen Zugriff zu ermöglichen. Zeichenfolge (erforderlich)
fileMode Diese Eigenschaft gilt nur für Dateien, die auf Linux-Computeknoten heruntergeladen werden. Sie wird ignoriert, wenn sie für eine resourceFile angegeben wird, die auf einen Windows-Knoten heruntergeladen wird. Wenn diese Eigenschaft für einen Linux-Knoten nicht angegeben ist, wird auf die Datei ein Standardwert von 0770 angewendet. Schnur
filePath Der Speicherort auf dem Computeknoten, in den die Datei heruntergeladen werden soll, relativ zum Arbeitsverzeichnis der Aufgabe. Zeichenfolge (erforderlich)

ScaleSettings

Name Beschreibung Wert
AutoScale Diese Eigenschaft und fixedScale schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. AutoScaleSettings-
fixedScale Diese Eigenschaft und autoScale schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. FixedScaleSettings-

StartTask

Name Beschreibung Wert
commandLine Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux. Erforderlich, wenn andere Eigenschaften des startTask angegeben werden. Schnur
environmentSettings Eine Liste der Umgebungsvariableneinstellungen für die Startaufgabe. EnvironmentSetting[]
maxTaskRetryCount Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Beachten Sie, dass dieser Wert speziell die Anzahl der Wiederholungen steuert. Der Batchdienst versucht die Aufgabe einmal und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn beispielsweise die maximale Wiederholungsanzahl 3 ist, versucht Batch den Vorgang bis zu 4 Mal (ein erster Versuch und 3 Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, führt der Batchdienst den Vorgang nicht erneut aus. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst den Vorgang ohne Beschränkung. Int
resourceFiles Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. ResourceFile-[]
userIdentity Wenn sie weggelassen wird, wird die Aufgabe als nicht administrativer Benutzer ausgeführt, der für die Aufgabe eindeutig ist. UserIdentity-
waitForSuccess Wenn true und die Startaufgabe auf einem Computeknoten fehlschlägt, wiederholt der Batchdienst die Startaufgabe bis zur maximalen Wiederholungsanzahl (maxTaskRetryCount). Wenn der Vorgang nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Computeknoten nicht mehr verwendbar, und er plant keine Vorgänge. Diese Bedingung kann über den Knotenstatus und das Planungsfehlerdetails erkannt werden. Wenn false, wartet der Batchdienst nicht, bis die Startaufgabe abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung auf dem Computeknoten beginnen, während die Startaufgabe noch ausgeführt wird. und auch wenn der Startvorgang fehlschlägt, werden neue Vorgänge weiterhin auf dem Knoten geplant. Der Standardwert ist "false". Bool

TaskSchedulingPolicy

Name Beschreibung Wert
nodeFillType Wie Aufgaben über Computeknoten verteilt werden sollen. "Pack"
"Spread" (erforderlich)

UserAccount

Name Beschreibung Wert
elevationLevel nonAdmin – Der automatische Benutzer ist ein Standardbenutzer ohne erhöhten Zugriff. admin – Der automatische Benutzer ist ein Benutzer mit erhöhtem Zugriff und arbeitet mit vollständigen Administratorberechtigungen. Der Standardwert ist "nonAdmin". "Administrator"
'NonAdmin'
linuxUserConfiguration Diese Eigenschaft wird ignoriert, wenn sie in einem Windows-Pool angegeben ist. Wenn nicht angegeben, wird der Benutzer mit den Standardoptionen erstellt. LinuxUserConfiguration-
Name Der Name des Benutzerkontos. Zeichenfolge (erforderlich)
Passwort Das Kennwort für das Benutzerkonto. Zeichenfolge (erforderlich)

UserIdentity

Name Beschreibung Wert
autoUser Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben. AutoUserSpecification-
Nutzername Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben. Schnur

VirtualMachineConfiguration

Name Beschreibung Wert
dataDisks Diese Eigenschaft muss angegeben werden, wenn die Computeknoten im Pool über leere Datenträger verfügen müssen, die an sie angefügt sind. DataDisk-[]
imageReference Ein Verweis auf ein Azure Virtual Machines Marketplace-Image oder die Azure Image-Ressource eines benutzerdefinierten virtuellen Computers. Informationen zum Abrufen der Liste aller imageReferences, die von Azure Batch überprüft wurden, finden Sie im Vorgang "Auflisten unterstützter Knoten-Agent-SKUs". ImageReference- (erforderlich)
licenseType Dies gilt nur für Images, die das Windows-Betriebssystem enthalten, und sollte nur verwendet werden, wenn Sie gültige lokale Lizenzen für die Knoten halten, die bereitgestellt werden. Ohne Angabe wird kein lokaler Lizenzierungsrabatt angewendet. Werte sind:

Windows_Server – Die lokale Lizenz gilt für Windows Server.
Windows_Client – Die lokale Lizenz ist für Windows Client.
Schnur
nodeAgentSkuId Der Batchknoten-Agent ist ein Programm, das auf jedem Knoten im Pool ausgeführt wird und die Befehls- und Steuerungsschnittstelle zwischen dem Knoten und dem Batchdienst bereitstellt. Es gibt unterschiedliche Implementierungen des Knoten-Agents, die als SKUs bezeichnet werden, für verschiedene Betriebssysteme. Sie müssen eine Knoten-Agent-SKU angeben, die dem ausgewählten Imageverweis entspricht. Informationen zum Abrufen der Liste der unterstützten Knoten-Agent-SKUs sowie deren Liste der überprüften Bildverweise finden Sie im Vorgang "Auflisten unterstützter Knoten-Agent-SKUs". Zeichenfolge (erforderlich)
osDisk Einstellungen für den Betriebssystemdatenträger des virtuellen Computers. OSDisk-
windowsConfiguration Diese Eigenschaft darf nicht angegeben werden, wenn das imageReference ein Linux-Betriebssystemimage angibt. WindowsConfiguration-

WindowsConfiguration

Name Beschreibung Wert
enableAutomaticUpdates Wenn dieser Wert nicht angegeben wird, ist der Standardwert "true". Bool

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone Beschreibung
Azure Batchpool ohne öffentliche IP-Adressen

Bereitstellen in Azure
Diese Vorlage erstellt einen vereinfachten Azure Batch-Knotenkommunikationspool ohne öffentliche IP-Adressen.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "batchAccounts/pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Ressource "Microsoft.Batch/batchAccounts/pools" zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Batch/batchAccounts/pools@2017-09-01"
  name = "string"
  body = jsonencode({
    properties = {
      applicationLicenses = [
        "string"
      ]
      applicationPackages = [
        {
          id = "string"
          version = "string"
        }
      ]
      certificates = [
        {
          id = "string"
          storeLocation = "string"
          storeName = "string"
          visibility = [
            "string"
          ]
        }
      ]
      deploymentConfiguration = {
        cloudServiceConfiguration = {
          currentOSVersion = "string"
          osFamily = "string"
          targetOSVersion = "string"
        }
        virtualMachineConfiguration = {
          dataDisks = [
            {
              caching = "string"
              diskSizeGB = int
              lun = int
              storageAccountType = "string"
            }
          ]
          imageReference = {
            id = "string"
            offer = "string"
            publisher = "string"
            sku = "string"
            version = "string"
          }
          licenseType = "string"
          nodeAgentSkuId = "string"
          osDisk = {
            caching = "string"
          }
          windowsConfiguration = {
            enableAutomaticUpdates = bool
          }
        }
      }
      displayName = "string"
      interNodeCommunication = "string"
      maxTasksPerNode = int
      metadata = [
        {
          name = "string"
          value = "string"
        }
      ]
      networkConfiguration = {
        endpointConfiguration = {
          inboundNatPools = [
            {
              backendPort = int
              frontendPortRangeEnd = int
              frontendPortRangeStart = int
              name = "string"
              networkSecurityGroupRules = [
                {
                  access = "string"
                  priority = int
                  sourceAddressPrefix = "string"
                }
              ]
              protocol = "string"
            }
          ]
        }
        subnetId = "string"
      }
      scaleSettings = {
        autoScale = {
          evaluationInterval = "string"
          formula = "string"
        }
        fixedScale = {
          nodeDeallocationOption = "string"
          resizeTimeout = "string"
          targetDedicatedNodes = int
          targetLowPriorityNodes = int
        }
      }
      startTask = {
        commandLine = "string"
        environmentSettings = [
          {
            name = "string"
            value = "string"
          }
        ]
        maxTaskRetryCount = int
        resourceFiles = [
          {
            blobSource = "string"
            fileMode = "string"
            filePath = "string"
          }
        ]
        userIdentity = {
          autoUser = {
            elevationLevel = "string"
            scope = "string"
          }
          userName = "string"
        }
        waitForSuccess = bool
      }
      taskSchedulingPolicy = {
        nodeFillType = "string"
      }
      userAccounts = [
        {
          elevationLevel = "string"
          linuxUserConfiguration = {
            gid = int
            sshPrivateKey = "string"
            uid = int
          }
          name = "string"
          password = "string"
        }
      ]
      vmSize = "string"
    }
  })
}

Eigenschaftswerte

ApplicationPackageReference

Name Beschreibung Wert
id Die ID des zu installierenden Anwendungspakets. Dies muss sich innerhalb desselben Batchkontos wie der Pool befinden. Dies kann entweder ein Verweis auf eine bestimmte Version oder die Standardversion sein, falls vorhanden. Zeichenfolge (erforderlich)
Version Wenn dies nicht angegeben wird und für diese Anwendung keine Standardversion angegeben wird, schlägt die Anforderung mit dem Fehlercode InvalidApplicationPackageReferences fehl. Wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 409. Schnur

AutoScaleSettings

Name Beschreibung Wert
evaluationInterval Wenn dieser Wert nicht angegeben wird, beträgt der Standardwert 15 Minuten (PT15M). Schnur
Formel Eine Formel für die gewünschte Anzahl von Computeknoten im Pool. Zeichenfolge (erforderlich)

AutoUserSpecification

Name Beschreibung Wert
elevationLevel nonAdmin – Der automatische Benutzer ist ein Standardbenutzer ohne erhöhten Zugriff. admin – Der automatische Benutzer ist ein Benutzer mit erhöhtem Zugriff und arbeitet mit vollständigen Administratorberechtigungen. Der Standardwert ist "nonAdmin". "Administrator"
'NonAdmin'
Umfang pool – gibt an, dass die Aufgabe als allgemeines automatisches Benutzerkonto ausgeführt wird, das auf jedem Knoten in einem Pool erstellt wird. task - gibt an, dass der Dienst einen neuen Benutzer für die Aufgabe erstellen soll. Der Standardwert ist "Task". "Pool"
"Vorgang"

CertificateReference

Name Beschreibung Wert
id Die vollqualifizierte ID des Zertifikats, das im Pool installiert werden soll. Dies muss sich innerhalb desselben Batchkontos wie der Pool befinden. Zeichenfolge (erforderlich)
storeLocation Der Standardwert ist currentUser. Diese Eigenschaft gilt nur für Pools, die mit Windows-Knoten konfiguriert sind (d. a. erstellt mit cloudServiceConfiguration oder mit virtualMachineConfiguration mithilfe eines Windows-Imageverweises). Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis der Aufgabe gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR der Aufgabe bereitgestellt wird, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von "remoteUser" wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers (z. B. /home/{user-name}/certs) erstellt und Zertifikate in diesem Verzeichnis platziert. 'CurrentUser'
"LocalMachine"
storeName Diese Eigenschaft gilt nur für Pools, die mit Windows-Knoten konfiguriert sind (d. a. erstellt mit cloudServiceConfiguration oder mit virtualMachineConfiguration mithilfe eines Windows-Imageverweises). Allgemeine Store-Namen sind: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, but any custom store name can also be used. Der Standardwert ist "Mein". Schnur
Sichtbarkeit Werte sind:

starttask – Das Benutzerkonto, unter dem die Startaufgabe ausgeführt wird.
task – Die Konten, unter denen Auftragsaufgaben ausgeführt werden.
remoteuser – Die Konten, unter denen Benutzer remote auf den Knoten zugreifen.

Sie können in dieser Sammlung mehr als eine Sichtbarkeit angeben. Der Standardwert ist alle Konten.
Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'RemoteUser'
"StartTask"
"Vorgang"

CloudServiceConfiguration

Name Beschreibung Wert
currentOSVersion Dies kann sich von targetOSVersion unterscheiden, wenn der Poolstatus "Upgrade" lautet. In diesem Fall befinden sich einige virtuelle Computer möglicherweise auf der targetOSVersion und einige befinden sich möglicherweise während des Upgradevorgangs auf dem currentOSVersion.In this case some virtual machines may be on the targetOSVersion and some may be on the currentOSVersion during the upgrade process. Sobald alle virtuellen Computer aktualisiert wurden, wird currentOSVersion so aktualisiert, dass sie mit targetOSVersion identisch ist. Schnur
osFamily Mögliche Werte sind: 2 – Betriebssystemfamilie 2, entspricht Windows Server 2008 R2 SP1. 3 – Betriebssystemfamilie 3, entspricht Windows Server 2012. 4 – Betriebssystemfamilie 4, entspricht Windows Server 2012 R2. 5 – Betriebssystemfamilie 5, entspricht Windows Server 2016. Weitere Informationen finden Sie unter Azure Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). Zeichenfolge (erforderlich)
targetOSVersion Der Standardwert ist * und gibt die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie an. Schnur

DataDisk

Name Beschreibung Wert
Caching Werte sind:

none – Der Cachemodus für den Datenträger ist nicht aktiviert.
readOnly – Der Cachemodus für den Datenträger ist schreibgeschützt.
readWrite – Der Cachemodus für den Datenträger ist lese- und schreibgeschützt.

Der Standardwert für die Zwischenspeicherung ist keine. Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
'None'
'ReadOnly'
'ReadWrite'
diskSizeGB Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Datenträgers. int (erforderlich)
lun Die Lun wird verwendet, um jeden Datenträger eindeutig zu identifizieren. Wenn sie mehrere Datenträger anfügen, sollte jeder eine unterschiedliche Lun aufweisen. int (erforderlich)
storageAccountType Wenn nicht angegeben, lautet der Standardwert "Standard_LRS". Werte sind:

Standard_LRS – Der Datenträger sollte standardmäßigen lokal redundanten Speicher verwenden.
Premium_LRS – Der Datenträger sollte einen lokal redundanten Premiumspeicher verwenden.
"Premium_LRS"
"Standard_LRS"

DeploymentConfiguration

Name Beschreibung Wert
cloudServiceConfiguration Diese Eigenschaft und virtualMachineConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. Diese Eigenschaft kann nicht angegeben werden, wenn das Batchkonto mit der poolAllocationMode-Eigenschaft erstellt wurde, die auf "UserSubscription" festgelegt ist. CloudServiceConfiguration-
virtualMachineConfiguration Diese Eigenschaft und cloudServiceConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. VirtualMachineConfiguration

EnvironmentSetting

Name Beschreibung Wert
Name Der Name der Umgebungsvariable. Zeichenfolge (erforderlich)
Wert Der Wert der Umgebungsvariable. Schnur

FixedScaleSettings

Name Beschreibung Wert
nodeDeallocationOption Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "Requeue". 'Requeue'
"RetainedData"
"TaskCompletion"
"Beenden"
resizeTimeout Der Standardwert beträgt 15 Minuten. Timeoutwerte verwenden das ISO 8601-Format. Verwenden Sie z. B. PT10M für 10 Minuten. Der Mindestwert beträgt 5 Minuten. Wenn Sie einen Wert kleiner als 5 Minuten angeben, lehnt der Batchdienst die Anforderung mit einem Fehler ab; wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung). Schnur
targetDedicatedNodes Mindestens einer von targetDedicatedNodes muss targetLowPriority-Knoten festgelegt werden. Int
targetLowPriorityNodes Mindestens einer von targetDedicatedNodes muss targetLowPriority-Knoten festgelegt werden. Int

ImageReference

Name Beschreibung Wert
id Diese Eigenschaft schließt sich gegenseitig mit anderen Eigenschaften aus. Das Image des virtuellen Computers muss sich in derselben Region und demselben Abonnement wie das Azure Batch-Konto befinden. Informationen zu den Firewalleinstellungen für den Batchknoten-Agent für die Kommunikation mit dem Batchdienst finden Sie unter "/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration". Schnur
Angebot Beispiel: UbuntuServer oder WindowsServer. Schnur
Verlag Beispiel: Canonical oder MicrosoftWindowsServer. Schnur
Sku Beispiel: 14.04.0-LTS oder 2012-R2-Datacenter. Schnur
Version Ein Wert von "latest" kann angegeben werden, um die neueste Version eines Bilds auszuwählen. Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "latest". Schnur

InboundNatPool

Name Beschreibung Wert
backPort Dies muss innerhalb eines Batchpools eindeutig sein. Zulässige Werte liegen zwischen 1 und 65535, mit Ausnahme von 22, 3389, 29876 und 29877, da diese reserviert sind. Wenn reservierte Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. int (erforderlich)
frontendPortRangeEnd Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die vom Batchdienst reserviert sind. Alle Bereiche innerhalb eines Pools müssen eindeutig sein und können nicht überlappen. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. int (erforderlich)
frontendPortRangeStart Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die reserviert sind. Alle Bereiche innerhalb eines Pools müssen eindeutig sein und können nicht überlappen. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. int (erforderlich)
Name Der Name muss innerhalb eines Batchpools eindeutig sein, kann Buchstaben, Zahlen, Unterstriche, Punkte und Bindestriche enthalten. Namen müssen mit einem Buchstaben oder einer Zahl beginnen, müssen mit einem Buchstaben, einer Zahl oder einem Unterstrich enden und dürfen 77 Zeichen nicht überschreiten. Wenn ungültige Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. Zeichenfolge (erforderlich)
networkSecurityGroupRules Die maximale Anzahl von Regeln, die für alle Endpunkte in einem Batchpool angegeben werden können, beträgt 25. Wenn keine Regeln für Netzwerksicherheitsgruppen angegeben sind, wird eine Standardregel erstellt, um den eingehenden Zugriff auf den angegebenen Back-EndPort zuzulassen. Wenn die maximale Anzahl von Netzwerksicherheitsgruppenregeln überschritten wird, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. NetworkSecurityGroupRule[]
Protokoll Das Protokoll des Endpunkts. "TCP"
"UDP" (erforderlich)

LinuxUserConfiguration

Name Beschreibung Wert
gid Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird das Gid ausgewählt. Int
sshPrivateKey Der private Schlüssel darf nicht kennwortgeschützter Schlüssel sein. Der private Schlüssel wird verwendet, um die asymmetrische schlüsselbasierte Authentifizierung für SSH zwischen Knoten in einem Linux-Pool automatisch zu konfigurieren, wenn die Eigenschaft enableInterNodeCommunication des Pools wahr ist (wird ignoriert, wenn enableInterNodeCommunication false ist). Dazu wird das Schlüsselpaar in das SSH-Verzeichnis des Benutzers eingefügt. Wenn nicht angegeben, wird kennwortloses SSH nicht zwischen Knoten konfiguriert (es erfolgt keine Änderung des SSH-Verzeichnisses des Benutzers). Schnur
uid Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird die UID ausgewählt. Int

MetadataItem

Name Beschreibung Wert
Name Der Name des Metadatenelements. Zeichenfolge (erforderlich)
Wert Der Wert des Metadatenelements. Zeichenfolge (erforderlich)

Microsoft.Batch/batchAccounts/pools

Name Beschreibung Wert
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 64
Pattern = ^[a-zA-Z0-9_-]+$ (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource des Typs: batchAccounts
Eigenschaften Die dem Pool zugeordneten Eigenschaften. PoolProperties-
Art Der Ressourcentyp "Microsoft.Batch/batchAccounts/pools@2017-09-01"

NetworkConfiguration

Name Beschreibung Wert
endpointConfiguration Die Poolendpunktkonfiguration wird nur für Pools mit der virtualMachineConfiguration-Eigenschaft unterstützt. PoolEndpointConfiguration
subnetz-ID Das virtuelle Netzwerk muss sich in derselben Region und im gleichen Abonnement wie das Azure Batch-Konto befinden. Das angegebene Subnetz sollte über genügend freie IP-Adressen verfügen, um die Anzahl der Knoten im Pool aufzunehmen. Wenn das Subnetz nicht über genügend freie IP-Adressen verfügt, weist der Pool teilweise Computeknoten zu, und es tritt ein Fehler bei der Größenänderung auf. Der Dienstprinzipal "MicrosoftAzureBatch" muss über die Rolle "Classic Virtual Machine Contributor" Role-Based Access Control (RBAC) für das angegebene VNet verfügen. Das angegebene Subnetz muss zulassen, dass die Kommunikation vom Azure Batch-Dienst Vorgänge auf den Computeknoten planen kann. Dies kann überprüft werden, indem überprüft wird, ob das angegebene VNet über alle zugehörigen Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt. Wenn die Kommunikation mit den Computeknoten im angegebenen Subnetz von einer NSG verweigert wird, legt der Batchdienst den Status der Computeknoten auf unbrauchbar fest. Für Pools, die über virtualMachineConfiguration erstellt werden, muss das Batchkonto über poolAllocationMode userSubscription verfügen, um ein VNet verwenden zu können. Wenn das angegebene VNet über eine zugeordnete Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt, müssen einige reservierte Systemports für eingehende Kommunikation aktiviert werden. Aktivieren Sie für Pools, die mit einer Konfiguration für virtuelle Computer erstellt wurden, ports 29876 und 29877 sowie Port 22 für Linux und Port 3389 für Windows. Aktivieren Sie für Pools, die mit einer Clouddienstkonfiguration erstellt wurden, ports 10100, 20100 und 30100. Aktivieren Sie auch ausgehende Verbindungen mit Azure Storage auf Port 443. Weitere Informationen finden Sie unter :/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration Schnur

NetworkSecurityGroupRule

Name Beschreibung Wert
Zugang Die Aktion, die für eine angegebene IP-Adresse, einen Subnetzbereich oder ein Bestimmtes Tag ausgeführt werden soll. "Zulassen"
"Verweigern" (erforderlich)
Priorität Prioritäten innerhalb eines Pools müssen eindeutig sein und in der Reihenfolge der Priorität ausgewertet werden. Je niedriger die Zahl ist, desto höher ist die Priorität. Regeln können beispielsweise mit den Bestellnummern 150, 250 und 350 angegeben werden. Die Regel mit der Bestellnummer 150 hat Vorrang vor der Regel mit einer Reihenfolge von 250. Zulässige Prioritäten sind 150 bis 3500. Wenn reservierte oder doppelte Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. int (erforderlich)
sourceAddressPrefix Gültige Werte sind eine einzelne IP-Adresse (d. h. 10.10.10.10), IP-Subnetz (d. h. 192.168.1.0/24), Standardtag oder * (für alle Adressen). Wenn andere Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. Zeichenfolge (erforderlich)

OSDisk

Name Beschreibung Wert
Caching Der Standardwert ist keine. 'None'
'ReadOnly'
'ReadWrite'

PoolEndpointConfiguration

Name Beschreibung Wert
inboundNatPools Die maximale Anzahl eingehender NAT-Pools pro Batchpool beträgt 5. Wenn die maximale Anzahl eingehender NAT-Pools überschritten wird, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. InboundNatPool-[] (erforderlich)

PoolProperties

Name Beschreibung Wert
applicationLicenses Die Liste der Anwendungslizenzen muss eine Teilmenge der verfügbaren Batchdienstanwendungslizenzen sein. Wenn eine Lizenz angefordert wird, die nicht unterstützt wird, schlägt die Poolerstellung fehl. string[]
applicationPackages Änderungen an Anwendungspaketen wirken sich auf alle neuen Computeknoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages neu erstellt werden. ApplicationPackageReference[]
Atteste Für Windows-Computeknoten installiert der Batchdienst die Zertifikate im angegebenen Zertifikatspeicher und -speicherort. Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis der Aufgabe gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR der Aufgabe bereitgestellt wird, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von "remoteUser" wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers (z. B. /home/{user-name}/certs) erstellt und Zertifikate in diesem Verzeichnis platziert. CertificateReference-[]
deploymentConfiguration Die Verwendung von CloudServiceConfiguration gibt an, dass die Knoten mithilfe von Azure Cloud Services (PaaS) erstellt werden sollen, während VirtualMachineConfiguration Azure Virtual Machines (IaaS) verwendet. DeploymentConfiguration-
displayName Der Anzeigename muss nicht eindeutig sein und kann alle Unicode-Zeichen bis zu einer maximalen Länge von 1024 enthalten. Schnur
interNodeCommunication Dadurch werden Einschränkungen auferlegt, denen dem Pool Knoten zugewiesen werden können. Durch Aktivieren dieses Werts kann die Wahrscheinlichkeit verringert werden, dass die angeforderte Anzahl von Knoten im Pool zugewiesen werden soll. Wenn nicht angegeben, wird dieser Wert standardmäßig auf "Deaktiviert" festgelegt. "Deaktiviert"
"Aktiviert"
maxTasksPerNode Die maximale Anzahl von Aufgaben, die gleichzeitig auf einem einzelnen Computeknoten im Pool ausgeführt werden können. Int
Metadaten Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen. MetadataItem-[]
networkConfiguration Die Netzwerkkonfiguration für einen Pool. NetworkConfiguration-
scaleSettings Definiert die gewünschte Größe des Pools. Dies kann entweder "fixedScale" sein, bei dem die angeforderten targetDedicatedNodes angegeben sind, oder 'autoScale', die eine Formel definiert, die regelmäßig neu ausgewertet wird. Wenn diese Eigenschaft nicht angegeben ist, hat der Pool eine feste Skalierung mit 0 targetDedicatedNodes. ScaleSettings-
startTask In einem PATCH-Vorgang (Update) kann diese Eigenschaft auf ein leeres Objekt festgelegt werden, um die Startaufgabe aus dem Pool zu entfernen. StartTask-
taskSchedulingPolicy Gibt an, wie Aufgaben über Computeknoten verteilt werden sollen. TaskSchedulingPolicy-
userAccounts Die Liste der Benutzerkonten, die auf jedem Knoten im Pool erstellt werden sollen. UserAccount[]
vmSize Informationen zu verfügbaren Größen virtueller Computer für Cloud Services-Pools (mit CloudServiceConfiguration erstellte Pools) finden Sie unter Größen für Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch unterstützt alle VM-Größen der Clouddienste mit Ausnahme von ExtraSmall. Informationen zu verfügbaren VM-Größen für Pools mit Images vom Virtual Machines Marketplace (Pools, die mit virtualMachineConfiguration erstellt wurden) finden Sie unter Größen für virtuelle Computer (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) oder Größen für virtuelle Computer (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch unterstützt alle Azure VM-Größen außer STANDARD_A0 und denen mit Premiumspeicher (STANDARD_GS, STANDARD_DS und STANDARD_DSV2 Serie). Schnur

ResourceFile

Name Beschreibung Wert
blobSource Diese URL muss mithilfe des anonymen Zugriffs lesbar sein; d. h. der Batchdienst stellt beim Herunterladen des Blobs keine Anmeldeinformationen bereit. Es gibt zwei Möglichkeiten, eine solche URL für ein Blob im Azure-Speicher abzurufen: Schließen Sie eine SAS (Shared Access Signature) ein, die Leseberechtigungen für das Blob gewährt, oder legen Sie die ACL für das Blob oder dessen Container fest, um den öffentlichen Zugriff zu ermöglichen. Zeichenfolge (erforderlich)
fileMode Diese Eigenschaft gilt nur für Dateien, die auf Linux-Computeknoten heruntergeladen werden. Sie wird ignoriert, wenn sie für eine resourceFile angegeben wird, die auf einen Windows-Knoten heruntergeladen wird. Wenn diese Eigenschaft für einen Linux-Knoten nicht angegeben ist, wird auf die Datei ein Standardwert von 0770 angewendet. Schnur
filePath Der Speicherort auf dem Computeknoten, in den die Datei heruntergeladen werden soll, relativ zum Arbeitsverzeichnis der Aufgabe. Zeichenfolge (erforderlich)

ScaleSettings

Name Beschreibung Wert
AutoScale Diese Eigenschaft und fixedScale schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. AutoScaleSettings-
fixedScale Diese Eigenschaft und autoScale schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. FixedScaleSettings-

StartTask

Name Beschreibung Wert
commandLine Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux. Erforderlich, wenn andere Eigenschaften des startTask angegeben werden. Schnur
environmentSettings Eine Liste der Umgebungsvariableneinstellungen für die Startaufgabe. EnvironmentSetting[]
maxTaskRetryCount Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Beachten Sie, dass dieser Wert speziell die Anzahl der Wiederholungen steuert. Der Batchdienst versucht die Aufgabe einmal und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn beispielsweise die maximale Wiederholungsanzahl 3 ist, versucht Batch den Vorgang bis zu 4 Mal (ein erster Versuch und 3 Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, führt der Batchdienst den Vorgang nicht erneut aus. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst den Vorgang ohne Beschränkung. Int
resourceFiles Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. ResourceFile-[]
userIdentity Wenn sie weggelassen wird, wird die Aufgabe als nicht administrativer Benutzer ausgeführt, der für die Aufgabe eindeutig ist. UserIdentity-
waitForSuccess Wenn true und die Startaufgabe auf einem Computeknoten fehlschlägt, wiederholt der Batchdienst die Startaufgabe bis zur maximalen Wiederholungsanzahl (maxTaskRetryCount). Wenn der Vorgang nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Computeknoten nicht mehr verwendbar, und er plant keine Vorgänge. Diese Bedingung kann über den Knotenstatus und das Planungsfehlerdetails erkannt werden. Wenn false, wartet der Batchdienst nicht, bis die Startaufgabe abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung auf dem Computeknoten beginnen, während die Startaufgabe noch ausgeführt wird. und auch wenn der Startvorgang fehlschlägt, werden neue Vorgänge weiterhin auf dem Knoten geplant. Der Standardwert ist "false". Bool

TaskSchedulingPolicy

Name Beschreibung Wert
nodeFillType Wie Aufgaben über Computeknoten verteilt werden sollen. "Pack"
"Spread" (erforderlich)

UserAccount

Name Beschreibung Wert
elevationLevel nonAdmin – Der automatische Benutzer ist ein Standardbenutzer ohne erhöhten Zugriff. admin – Der automatische Benutzer ist ein Benutzer mit erhöhtem Zugriff und arbeitet mit vollständigen Administratorberechtigungen. Der Standardwert ist "nonAdmin". "Administrator"
'NonAdmin'
linuxUserConfiguration Diese Eigenschaft wird ignoriert, wenn sie in einem Windows-Pool angegeben ist. Wenn nicht angegeben, wird der Benutzer mit den Standardoptionen erstellt. LinuxUserConfiguration-
Name Der Name des Benutzerkontos. Zeichenfolge (erforderlich)
Passwort Das Kennwort für das Benutzerkonto. Zeichenfolge (erforderlich)

UserIdentity

Name Beschreibung Wert
autoUser Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben. AutoUserSpecification-
Nutzername Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben. Schnur

VirtualMachineConfiguration

Name Beschreibung Wert
dataDisks Diese Eigenschaft muss angegeben werden, wenn die Computeknoten im Pool über leere Datenträger verfügen müssen, die an sie angefügt sind. DataDisk-[]
imageReference Ein Verweis auf ein Azure Virtual Machines Marketplace-Image oder die Azure Image-Ressource eines benutzerdefinierten virtuellen Computers. Informationen zum Abrufen der Liste aller imageReferences, die von Azure Batch überprüft wurden, finden Sie im Vorgang "Auflisten unterstützter Knoten-Agent-SKUs". ImageReference- (erforderlich)
licenseType Dies gilt nur für Images, die das Windows-Betriebssystem enthalten, und sollte nur verwendet werden, wenn Sie gültige lokale Lizenzen für die Knoten halten, die bereitgestellt werden. Ohne Angabe wird kein lokaler Lizenzierungsrabatt angewendet. Werte sind:

Windows_Server – Die lokale Lizenz gilt für Windows Server.
Windows_Client – Die lokale Lizenz ist für Windows Client.
Schnur
nodeAgentSkuId Der Batchknoten-Agent ist ein Programm, das auf jedem Knoten im Pool ausgeführt wird und die Befehls- und Steuerungsschnittstelle zwischen dem Knoten und dem Batchdienst bereitstellt. Es gibt unterschiedliche Implementierungen des Knoten-Agents, die als SKUs bezeichnet werden, für verschiedene Betriebssysteme. Sie müssen eine Knoten-Agent-SKU angeben, die dem ausgewählten Imageverweis entspricht. Informationen zum Abrufen der Liste der unterstützten Knoten-Agent-SKUs sowie deren Liste der überprüften Bildverweise finden Sie im Vorgang "Auflisten unterstützter Knoten-Agent-SKUs". Zeichenfolge (erforderlich)
osDisk Einstellungen für den Betriebssystemdatenträger des virtuellen Computers. OSDisk-
windowsConfiguration Diese Eigenschaft darf nicht angegeben werden, wenn das imageReference ein Linux-Betriebssystemimage angibt. WindowsConfiguration-

WindowsConfiguration

Name Beschreibung Wert
enableAutomaticUpdates Wenn dieser Wert nicht angegeben wird, ist der Standardwert "true". Bool