Freigeben über


New-AzBatchPool

Erstellt einen Pool im Batchdienst.

Syntax

CloudServiceAndTargetDedicated (Standard)

New-AzBatchPool
    [-Id] <String>
    -VirtualMachineSize <String>
    -BatchContext <BatchAccountContext>
    [-DisplayName <String>]
    [-ResizeTimeout <TimeSpan>]
    [-TargetDedicatedComputeNodes <Int32>]
    [-TargetLowPriorityComputeNodes <Int32>]
    [-TaskSlotsPerNode <Int32>]
    [-UpgradePolicy <PSUpgradePolicy>]
    [-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
    [-Metadata <IDictionary>]
    [-InterComputeNodeCommunicationEnabled]
    [-StartTask <PSStartTask>]
    [-ApplicationPackageReferences <PSApplicationPackageReference[]>]
    [-NetworkConfiguration <PSNetworkConfiguration>]
    [-MountConfiguration <PSMountConfiguration[]>]
    [-UserAccount <PSUserAccount[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

VirtualMachineAndTargetDedicated

New-AzBatchPool
    [-Id] <String>
    -VirtualMachineSize <String>
    -BatchContext <BatchAccountContext>
    [-DisplayName <String>]
    [-ResizeTimeout <TimeSpan>]
    [-TargetDedicatedComputeNodes <Int32>]
    [-TargetLowPriorityComputeNodes <Int32>]
    [-TaskSlotsPerNode <Int32>]
    [-UpgradePolicy <PSUpgradePolicy>]
    [-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
    [-Metadata <IDictionary>]
    [-InterComputeNodeCommunicationEnabled]
    [-StartTask <PSStartTask>]
    [-ApplicationPackageReferences <PSApplicationPackageReference[]>]
    [-VirtualMachineConfiguration <PSVirtualMachineConfiguration>]
    [-NetworkConfiguration <PSNetworkConfiguration>]
    [-MountConfiguration <PSMountConfiguration[]>]
    [-UserAccount <PSUserAccount[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CloudServiceAndAutoScale

New-AzBatchPool
    [-Id] <String>
    -VirtualMachineSize <String>
    -BatchContext <BatchAccountContext>
    [-DisplayName <String>]
    [-AutoScaleEvaluationInterval <TimeSpan>]
    [-AutoScaleFormula <String>]
    [-TaskSlotsPerNode <Int32>]
    [-UpgradePolicy <PSUpgradePolicy>]
    [-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
    [-Metadata <IDictionary>]
    [-InterComputeNodeCommunicationEnabled]
    [-StartTask <PSStartTask>]
    [-ApplicationPackageReferences <PSApplicationPackageReference[]>]
    [-NetworkConfiguration <PSNetworkConfiguration>]
    [-MountConfiguration <PSMountConfiguration[]>]
    [-UserAccount <PSUserAccount[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

VirtualMachineAndAutoScale

New-AzBatchPool
    [-Id] <String>
    -VirtualMachineSize <String>
    -BatchContext <BatchAccountContext>
    [-DisplayName <String>]
    [-AutoScaleEvaluationInterval <TimeSpan>]
    [-AutoScaleFormula <String>]
    [-TaskSlotsPerNode <Int32>]
    [-UpgradePolicy <PSUpgradePolicy>]
    [-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
    [-Metadata <IDictionary>]
    [-InterComputeNodeCommunicationEnabled]
    [-StartTask <PSStartTask>]
    [-ApplicationPackageReferences <PSApplicationPackageReference[]>]
    [-VirtualMachineConfiguration <PSVirtualMachineConfiguration>]
    [-NetworkConfiguration <PSNetworkConfiguration>]
    [-MountConfiguration <PSMountConfiguration[]>]
    [-UserAccount <PSUserAccount[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzBatchPool erstellt einen Pool im Azure Batch-Dienst unter dem konto, das durch den Parameter BatchContext angegeben wird.

Beispiele

Beispiel 1: Erstellen eines neuen Pools mit dem Parameter "TargetDedicated" mithilfe von VirtualMachineConfiguration

$imageReference = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSImageReference" -ArgumentList @("WindowsServer", "MicrosoftWindowsServer", "2016-Datacenter", "*")
$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSVirtualMachineConfiguration" -ArgumentList @($imageReference, "batch.node.windows amd64")
New-AzBatchPool -Id "MyPool" -VirtualMachineSize "STANDARD_D1_V2" -VirtualMachineConfiguration $configuration -TargetDedicatedComputeNodes 3 -BatchContext $Context

Mit diesem Befehl wird ein neuer Pool mit der ID MyPool mit dem Parametersatz TargetDedicated erstellt. Die Zielzuordnung ist drei Computeknoten. Der Pool ist so konfiguriert, dass STANDARD_D1_V2 virtuellen Computer mit dem Windows-2016-Datacenter-Betriebssystemimage verwendet werden.

Beispiel 2: Erstellen eines neuen Pools mithilfe des AutoScale-Parametersatzes

$imageReference = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSImageReference" -ArgumentList @("WindowsServer", "MicrosoftWindowsServer", "2016-Datacenter", "*")
$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSVirtualMachineConfiguration" -ArgumentList @($imageReference, "batch.node.windows amd64")
New-AzBatchPool -Id "AutoScalePool" -VirtualMachineSize "STANDARD_D1_V2" -VirtualMachineConfiguration $configuration -AutoScaleFormula '$TargetDedicated=2;' -BatchContext $Context

Mit diesem Befehl wird ein neuer Pool mit DER ID AutoScalePool mit dem Parametersatz AutoScale erstellt. Der Pool ist für die Verwendung STANDARD_D1_V2 virtuellen Computer mit dem Windows-2016-Datacenter-Betriebssystemimage konfiguriert, und die Zielanzahl der Computeknoten wird durch die Autoskalenformel bestimmt.

Beispiel 3: Erstellen eines Pools mit Knoten in einem Subnetz

$imageReference = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSImageReference" -ArgumentList @("WindowsServer", "MicrosoftWindowsServer", "2016-Datacenter", "*")
$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSVirtualMachineConfiguration" -ArgumentList @($imageReference, "batch.node.windows amd64")
$networkConfig = New-Object Microsoft.Azure.Commands.Batch.Models.PSNetworkConfiguration
$networkConfig.SubnetId = "/subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}"
New-AzBatchPool -Id "AutoScalePool" -VirtualMachineSize "STANDARD_D1_V2" -VirtualMachineConfiguration $configuration -TargetDedicatedComputeNodes 3 -NetworkConfiguration $networkConfig -BatchContext $Context

Beispiel 4: Erstellen eines Pools mit benutzerdefinierten Benutzerkonten

$imageReference = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSImageReference" -ArgumentList @("WindowsServer", "MicrosoftWindowsServer", "2016-Datacenter", "*")
$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSVirtualMachineConfiguration" -ArgumentList @($imageReference, "batch.node.windows amd64")
$userAccount = New-Object Microsoft.Azure.Commands.Batch.Models.PSUserAccount -ArgumentList @("myaccount", "mypassword")
New-AzBatchPool -Id "AutoScalePool" -VirtualMachineSize "STANDARD_D1_V2" -VirtualMachineConfiguration $configuration -TargetDedicatedComputeNodes 3 -UserAccount $userAccount

Parameter

-ApplicationPackageReferences

Das Cmdlet New-AzBatchPool erstellt einen Pool im Azure Batch-Dienst unter dem konto, das durch den Parameter BatchContext angegeben wird.

Parametereigenschaften

Typ:

PSApplicationPackageReference[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ApplicationPackageReference

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-AutoScaleEvaluationInterval

Gibt die Zeitspanne in Minuten an, die verstrichen ist, bevor die Poolgröße gemäß der AutoScale-Formel automatisch angepasst wird. Der Standardwert beträgt 15 Minuten, und der Mindestwert beträgt 5 Minuten.

Parametereigenschaften

Typ:

Nullable<T>[TimeSpan]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

CloudServiceAndAutoScale
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
VirtualMachineAndAutoScale
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-AutoScaleFormula

Gibt die Formel für die automatische Skalierung des Pools an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

CloudServiceAndAutoScale
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
VirtualMachineAndAutoScale
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-BatchContext

Gibt die BatchAccountContext-Instanz an, die dieses Cmdlet für die Interaktion mit dem Batchdienst verwendet. Wenn Sie das Cmdlet Get-AzBatchAccount verwenden, um Ihren BatchAccountContext abzurufen, wird die Microsoft Entra-Authentifizierung bei der Interaktion mit dem Batchdienst verwendet. Verwenden Sie zum Verwenden der gemeinsamen Schlüsselauthentifizierung stattdessen das cmdlet Get-AzBatchAccountKey, um ein BatchAccountContext-Objekt mit den aufgefüllten Zugriffstasten abzurufen. Bei Verwendung der Authentifizierung mit gemeinsam genutzten Schlüsseln wird standardmäßig der primäre Zugriffsschlüssel verwendet. Um den zu verwendenden Schlüssel zu ändern, legen Sie die BatchAccountContext.KeyInUse-Eigenschaft fest.

Parametereigenschaften

Typ:BatchAccountContext
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisplayName

Gibt den Anzeigenamen des Pools an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

Gibt die ID des zu erstellenden Pools an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InterComputeNodeCommunicationEnabled

Gibt an, dass dieses Cmdlet den Pool für die direkte Kommunikation zwischen dedizierten Computeknoten einrichte.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Metadata

Gibt die Metadaten als Schlüssel-Wert-Paare an, die dem neuen Pool hinzugefügt werden sollen. Der Schlüssel ist der Metadatenname. Der Wert ist der Metadatenwert.

Parametereigenschaften

Typ:IDictionary
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MountConfiguration

Eine Liste der Dateisysteme, die auf jedem Knoten im Pool bereitgestellt werden sollen. Dies unterstützt Azure Files, NFS, CIFS/SMB und Blobfuse.

Parametereigenschaften

Typ:

PSMountConfiguration[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-NetworkConfiguration

Die Netzwerkkonfiguration für den Pool.

Parametereigenschaften

Typ:PSNetworkConfiguration
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResizeTimeout

Gibt das Timeout für die Zuordnung von Computeknoten an den Pool an.

Parametereigenschaften

Typ:

Nullable<T>[TimeSpan]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

CloudServiceAndTargetDedicated
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
VirtualMachineAndTargetDedicated
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StartTask

Gibt die Spezifikation für die Startaufgabe für den Pool an. Die Startaufgabe wird ausgeführt, wenn ein Computeknoten dem Pool beitritt oder wenn der Computeknoten neu gestartet oder umimages erstellt wird.

Parametereigenschaften

Typ:PSStartTask
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TargetDedicatedComputeNodes

Gibt die Zielanzahl der dedizierten Computeknoten an, die dem Pool zugewiesen werden sollen.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:TargetDedicated

Parametersätze

CloudServiceAndTargetDedicated
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
VirtualMachineAndTargetDedicated
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TargetLowPriorityComputeNodes

Gibt die Zielanzahl der Computeknoten mit niedriger Priorität an, die dem Pool zugewiesen werden sollen.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

CloudServiceAndTargetDedicated
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
VirtualMachineAndTargetDedicated
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TaskSchedulingPolicy

Gibt die Vorgangsplanungsrichtlinie an, z. B. "ComputeNodeFillType".

Parametereigenschaften

Typ:PSTaskSchedulingPolicy
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TaskSlotsPerNode

Die Anzahl von Taskslots, die verwendet werden können, um gleichzeitige Tasks auf einem einzelnen Computeknoten im Pool auszuführen. Der Standardwert ist 1. Der Maximalwert ist kleiner als 4 Mal die Anzahl der Kerne der vmSize des Pools oder 256.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:MaxTasksPerComputeNode

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UpgradePolicy

Die Upgraderichtlinie für den Pool in NewBatchPoolCommand.cs .

Parametereigenschaften

Typ:PSUpgradePolicy
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UserAccount

Die Liste der Benutzerkonten, die auf jedem Knoten im Pool erstellt werden sollen.

Parametereigenschaften

Typ:

PSUserAccount[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VirtualMachineConfiguration

Gibt Konfigurationseinstellungen für einen Pool in der Infrastruktur virtueller Computer an.

Parametereigenschaften

Typ:PSVirtualMachineConfiguration
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

VirtualMachineAndTargetDedicated
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
VirtualMachineAndAutoScale
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VirtualMachineSize

Gibt die Größe der virtuellen Computer im Pool an. Weitere Informationen zu den Größen virtueller Computer finden Sie unter "Größen für virtuelle Computer " auf der Microsoft Azure-Website.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

BatchAccountContext

Ausgaben

Void