New-AzBatchPool

模組:

Az.Batch

在 Batch 服務中建立集區。

語法

New-AzBatchPool
   [-Id] <String>
   -VirtualMachineSize <String>
   [-DisplayName <String>]
   [-ResizeTimeout <TimeSpan>]
   [-TargetDedicatedComputeNodes <Int32>]
   [-TargetLowPriorityComputeNodes <Int32>]
   [-TaskSlotsPerNode <Int32>]
   [-UpgradePolicy <PSUpgradePolicy>]
   [-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
   [-ResourceTag <IDictionary>]
   [-Metadata <IDictionary>]
   [-InterComputeNodeCommunicationEnabled]
   [-StartTask <PSStartTask>]
   [-CertificateReferences <PSCertificateReference[]>]
   [-ApplicationPackageReferences <PSApplicationPackageReference[]>]
   [-ApplicationLicenses <System.Collections.Generic.List`1[System.String]>]
   [-CloudServiceConfiguration <PSCloudServiceConfiguration>]
   [-NetworkConfiguration <PSNetworkConfiguration>]
   [-MountConfiguration <PSMountConfiguration[]>]
   [-UserAccount <PSUserAccount[]>]
   [-CurrentNodeCommunicationMode <NodeCommunicationMode>]
   [-TargetNodeCommunicationMode <NodeCommunicationMode>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzBatchPool
   [-Id] <String>
   -VirtualMachineSize <String>
   [-DisplayName <String>]
   [-ResizeTimeout <TimeSpan>]
   [-TargetDedicatedComputeNodes <Int32>]
   [-TargetLowPriorityComputeNodes <Int32>]
   [-TaskSlotsPerNode <Int32>]
   [-UpgradePolicy <PSUpgradePolicy>]
   [-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
   [-ResourceTag <IDictionary>]
   [-Metadata <IDictionary>]
   [-InterComputeNodeCommunicationEnabled]
   [-StartTask <PSStartTask>]
   [-CertificateReferences <PSCertificateReference[]>]
   [-ApplicationPackageReferences <PSApplicationPackageReference[]>]
   [-ApplicationLicenses <System.Collections.Generic.List`1[System.String]>]
   [-VirtualMachineConfiguration <PSVirtualMachineConfiguration>]
   [-NetworkConfiguration <PSNetworkConfiguration>]
   [-MountConfiguration <PSMountConfiguration[]>]
   [-UserAccount <PSUserAccount[]>]
   [-CurrentNodeCommunicationMode <NodeCommunicationMode>]
   [-TargetNodeCommunicationMode <NodeCommunicationMode>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzBatchPool
   [-Id] <String>
   -VirtualMachineSize <String>
   [-DisplayName <String>]
   [-AutoScaleEvaluationInterval <TimeSpan>]
   [-AutoScaleFormula <String>]
   [-TaskSlotsPerNode <Int32>]
   [-UpgradePolicy <PSUpgradePolicy>]
   [-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
   [-ResourceTag <IDictionary>]
   [-Metadata <IDictionary>]
   [-InterComputeNodeCommunicationEnabled]
   [-StartTask <PSStartTask>]
   [-CertificateReferences <PSCertificateReference[]>]
   [-ApplicationPackageReferences <PSApplicationPackageReference[]>]
   [-ApplicationLicenses <System.Collections.Generic.List`1[System.String]>]
   [-CloudServiceConfiguration <PSCloudServiceConfiguration>]
   [-NetworkConfiguration <PSNetworkConfiguration>]
   [-MountConfiguration <PSMountConfiguration[]>]
   [-UserAccount <PSUserAccount[]>]
   [-CurrentNodeCommunicationMode <NodeCommunicationMode>]
   [-TargetNodeCommunicationMode <NodeCommunicationMode>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzBatchPool
   [-Id] <String>
   -VirtualMachineSize <String>
   [-DisplayName <String>]
   [-AutoScaleEvaluationInterval <TimeSpan>]
   [-AutoScaleFormula <String>]
   [-TaskSlotsPerNode <Int32>]
   [-UpgradePolicy <PSUpgradePolicy>]
   [-TaskSchedulingPolicy <PSTaskSchedulingPolicy>]
   [-ResourceTag <IDictionary>]
   [-Metadata <IDictionary>]
   [-InterComputeNodeCommunicationEnabled]
   [-StartTask <PSStartTask>]
   [-CertificateReferences <PSCertificateReference[]>]
   [-ApplicationPackageReferences <PSApplicationPackageReference[]>]
   [-ApplicationLicenses <System.Collections.Generic.List`1[System.String]>]
   [-VirtualMachineConfiguration <PSVirtualMachineConfiguration>]
   [-NetworkConfiguration <PSNetworkConfiguration>]
   [-MountConfiguration <PSMountConfiguration[]>]
   [-UserAccount <PSUserAccount[]>]
   [-CurrentNodeCommunicationMode <NodeCommunicationMode>]
   [-TargetNodeCommunicationMode <NodeCommunicationMode>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzBatchPool Cmdlet 會根據 BatchContext 參數所指定的帳戶，在 Azure Batch 服務中建立集區。

範例

範例 1：使用 CloudServiceConfiguration 設定 TargetDedicated 參數建立新的集區

$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSCloudServiceConfiguration" -ArgumentList @(4,"*")
New-AzBatchPool -Id "MyPool" -VirtualMachineSize "STANDARD_D1_V2" -CloudServiceConfiguration $configuration  -TargetDedicatedComputeNodes 3 -BatchContext $Context

集區已設定為使用STANDARD_D1_V2虛擬機與系列四的作業系統版本。

範例 2：使用 VirtualMachineConfiguration 設定 TargetDedicated 參數集建立新的集區

$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

此命令會使用 TargetDedicated 參數集建立標識碼為 MyPool 的新集區。 目標配置是三個計算節點。 集區已設定為使用STANDARD_D1_V2虛擬機搭配 Windows-2016-Datacenter 操作系統映像。

範例 3：使用 AutoScale 參數集建立新的集區

$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

此命令會使用 AutoScale 參數集建立標識符為 AutoScalePool 的新集區。 集區設定為使用STANDARD_D1_V2虛擬機搭配 Windows-2016-Datacenter 操作系統映射，而計算節點的目標數目是由自動調整公式所決定。

範例 4：使用子網中的節點建立集區

$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

範例 5：使用自定義用戶帳戶建立集區

$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

參數

-ApplicationLicenses

Batch 服務將在集區中的每個計算節點上提供應用程式授權清單。

類型:	List<T>[String]
別名:	ApplicationLicense
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ApplicationPackageReferences

類型:	PSApplicationPackageReference[]
別名:	ApplicationPackageReference
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AutoScaleEvaluationInterval

指定集區大小根據自動調整公式自動調整之前所經過的時間量，以分鐘為單位。 默認值為 15 分鐘，最小值為 5 分鐘。

類型:	Nullable<T>[TimeSpan]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AutoScaleFormula

指定自動調整集區的公式。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-BatchContext

指定 此 Cmdlet 用來與 Batch 服務互動的 BatchAccountContext 實例。 如果您使用 Get-AzBatchAccount Cmdlet 來取得 BatchAccountContext，則與 Batch 服務互動時，將會使用Microsoft Entra 驗證。 若要改用共用密鑰驗證，請使用 Get-AzBatchAccountKey Cmdlet 來取得已填入其存取密鑰的 BatchAccountContext 物件。 使用共用金鑰驗證時，預設會使用主要存取金鑰。 若要變更要使用的密鑰，請設定 BatchAccountContext.KeyInUse 屬性。

類型:	BatchAccountContext
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-CertificateReferences

指定與集區相關聯的憑證。 Batch 服務會在集區的每個計算節點上安裝參考的憑證。

類型:	PSCertificateReference[]
別名:	CertificateReference
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CloudServiceConfiguration

根據 Azure 雲端服務平臺指定集區的組態設定。

類型:	PSCloudServiceConfiguration
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CurrentNodeCommunicationMode

目前的集區通訊模式。

類型:	NodeCommunicationMode
接受的值:	Default, Classic, Simplified
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisplayName

指定集區的顯示名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Id

指定要建立的集區標識碼。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-InterComputeNodeCommunicationEnabled

指出此 Cmdlet 會設定集區，以在專用計算節點之間進行直接通訊。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Metadata

將元數據指定為索引鍵/值組，以新增至新的集區。 索引鍵是元數據名稱。 值是元數據值。

類型:	IDictionary
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MountConfiguration

要掛接在集區中每個節點上的檔案系統清單。 這支援 Azure 檔案儲存體、NFS、CIFS/SMB 和 Blobfuse。

類型:	PSMountConfiguration[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-NetworkConfiguration

集區的網路組態。

類型:	PSNetworkConfiguration
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResizeTimeout

指定將計算節點配置至集區的逾時。

類型:	Nullable<T>[TimeSpan]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceTag

要與 Azure Batch 集區相關聯的使用者定義標籤。指定時，這些標籤會傳播到與集區相關聯的備份 Azure 資源。只有在使用 poolAllocationMode 屬性設定為 'UserSubscription' 建立 Batch 帳戶時，才能指定這個屬性。

類型:	IDictionary
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-StartTask

指定集區的開始工作規格。 當計算節點加入集區，或計算節點重新啟動或重新映像時，就會執行啟動工作。

類型:	PSStartTask
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TargetDedicatedComputeNodes

指定要配置給集區之專用計算節點的目標數目。

類型:	Nullable<T>[Int32]
別名:	TargetDedicated
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TargetLowPriorityComputeNodes

指定要配置給集區之低優先順序計算節點的目標數目。

類型:	Nullable<T>[Int32]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TargetNodeCommunicationMode

集區所需的節點通訊模式。

類型:	NodeCommunicationMode
接受的值:	Default, Classic, Simplified
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TaskSchedulingPolicy

指定工作排程原則，例如 ComputeNodeFillType。

類型:	PSTaskSchedulingPolicy
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TaskSlotsPerNode

可用於在集區中單一計算節點上執行並行工作的工作位置數目。 預設值是 1秒。 最大值是集區 vmSize 或 256 核心數目的 4 倍小。

類型:	Nullable<T>[Int32]
別名:	MaxTasksPerComputeNode
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UpgradePolicy

NewBatchPoolCommand.cs 中集區的升級原則。

類型:	PSUpgradePolicy
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UserAccount

要建立於集區中每個節點上的用戶帳戶清單。

類型:	PSUserAccount[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VirtualMachineConfiguration

指定虛擬機基礎結構上集區的組態設定。

類型:	PSVirtualMachineConfiguration
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VirtualMachineSize

指定集區中虛擬機的大小。 如需虛擬機大小的詳細資訊，請參閱 Microsoft Azure 網站中的虛擬機 大小。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

BatchAccountContext

輸出

Void

相關連結

• Get-AzBatchAccountKey
• Get-AzBatchPool
• Remove-AzBatchPool
• Azure Batch Cmdlet