New-AzBatchPool

模組:

Az.Batch Module

在 Batch 服務中建立集區。

語法

CloudServiceAndTargetDedicated (預設值)

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

Description

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

範例

範例 1：使用 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 參數集建立 ID 為 MyPool 的新集區。 目標配置是三個運算節點。 集區設定為使用具有 Windows-2016-Datacenter 作業系統映像的STANDARD_D1_V2虛擬機器。

範例 2：使用 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 的新集區。 集區會設定為搭配 Windows-2016-Datacenter 作業系統映像使用STANDARD_D1_V2虛擬機器，而計算節點的目標數目是由自動調整公式所決定。

範例 3：建立一個包含子網節點的池

$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

範例 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")
$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

參數

-ApplicationPackageReferences

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

參數屬性

類型:	PSApplicationPackageReference[]
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	ApplicationPackage引用

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AutoScaleEvaluationInterval

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

參數屬性

類型:	Nullable<T>[TimeSpan]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CloudServiceAndAutoScale

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

VirtualMachineAndAutoScale

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AutoScaleFormula

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CloudServiceAndAutoScale

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

VirtualMachineAndAutoScale

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-BatchContext

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

參數屬性

類型:	BatchAccountContext
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DefaultProfile

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

參數屬性

類型:	IAzureContextContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzContext, AzureRmContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DisplayName

指定集區的顯示名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Id

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-InterComputeNodeCommunicationEnabled

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Metadata

將中繼資料指定為索引鍵/值組，以新增至新集區。 索引鍵是中繼資料名稱。 值是中繼資料值。

參數屬性

類型:	IDictionary
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MountConfiguration

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

參數屬性

類型:	PSMountConfiguration[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-NetworkConfiguration

集區的網路組態。

參數屬性

類型:	PSNetworkConfiguration
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ResizeTimeout

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

參數屬性

類型:	Nullable<T>[TimeSpan]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CloudServiceAndTargetDedicated

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

VirtualMachineAndTargetDedicated

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-StartTask

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

參數屬性

類型:	PSStartTask
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-TargetDedicatedComputeNodes

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

參數屬性

類型:	Nullable<T>[Int32]
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	目標專用

參數集

CloudServiceAndTargetDedicated

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

VirtualMachineAndTargetDedicated

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-TargetLowPriorityComputeNodes

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

參數屬性

類型:	Nullable<T>[Int32]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CloudServiceAndTargetDedicated

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

VirtualMachineAndTargetDedicated

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-TaskSchedulingPolicy

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

參數屬性

類型:	PSTaskSchedulingPolicy
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-TaskSlotsPerNode

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

參數屬性

類型:	Nullable<T>[Int32]
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	MaxTasksPerComputeNode

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-UpgradePolicy

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

參數屬性

類型:	PSUpgradePolicy
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-UserAccount

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

參數屬性

類型:	PSUserAccount[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-VirtualMachineConfiguration

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

參數屬性

類型:	PSVirtualMachineConfiguration
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

VirtualMachineAndTargetDedicated

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

VirtualMachineAndAutoScale

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-VirtualMachineSize

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	威斯康辛

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

BatchAccountContext

輸出

Void

相關連結

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