Udostępnij za pośrednictwem

New-AzBatchPool

  • Odwołanie
Moduł:
Az.Batch

Tworzy pulę w usłudze Batch.

Składnia

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

Opis

Polecenie cmdlet New-AzBatchPool tworzy pulę w usłudze Azure Batch na koncie określonym przez parametr BatchContext .

Przykłady

Przykład 1. Tworzenie nowej puli przy użyciu zestawu parametrów TargetDedicated przy użyciu klasy CloudServiceConfiguration

$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

Pula jest skonfigurowana do używania STANDARD_D1_V2 maszyn wirtualnych z wersją systemu operacyjnego rodziny cztery.

Przykład 2. Tworzenie nowej puli przy użyciu zestawu parametrów TargetDedicated przy użyciu funkcji 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

To polecenie tworzy nową pulę z identyfikatorem MyPool przy użyciu zestawu parametrów TargetDedicated. Alokacja docelowa to trzy węzły obliczeniowe. Pula jest skonfigurowana do używania STANDARD_D1_V2 maszyn wirtualnych z obrazem systemu operacyjnego Windows-2016-Datacenter.

Przykład 3. Tworzenie nowej puli przy użyciu zestawu parametrów autoskalowania

$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

To polecenie tworzy nową pulę z pulą autoskalowania identyfikatorów przy użyciu zestawu parametrów autoskalowania. Pula jest skonfigurowana do używania STANDARD_D1_V2 maszyn wirtualnych z obrazem systemu operacyjnego Windows-2016-Datacenter, a docelowa liczba węzłów obliczeniowych jest określana przez formułę autoskalowania.

Przykład 4. Tworzenie puli z węzłami w podsieci

$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

Przykład 5. Tworzenie puli przy użyciu niestandardowych kont użytkowników

$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

Parametry

-ApplicationLicenses

Lista licencji aplikacji, które usługa Batch udostępni w każdym węźle obliczeniowym w puli.

Typ:List<T>[String]
Aliasy:ApplicationLicense
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ApplicationPackageReferences

Typ:PSApplicationPackageReference[]
Aliasy:ApplicationPackageReference
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AutoScaleEvaluationInterval

Określa czas w minutach, który upłynie przed automatycznym dostosowaniem rozmiaru puli zgodnie z formułą autoskalowania. Wartość domyślna to 15 minut, a minimalna wartość to 5 minut.

Typ:Nullable<T>[TimeSpan]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AutoScaleFormula

Określa formułę automatycznego skalowania puli.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-BatchContext

Określa wystąpienie BatchAccountContext używane przez to polecenie cmdlet do interakcji z usługą Batch. Jeśli użyjesz polecenia cmdlet Get-AzBatchAccount, aby uzyskać element BatchAccountContext, uwierzytelnianie Microsoft Entra będzie używane podczas interakcji z usługą Batch. Aby zamiast tego użyć uwierzytelniania klucza współużytkowanego, użyj polecenia cmdlet Get-AzBatchAccountKey, aby uzyskać obiekt BatchAccountContext z wypełnionymi kluczami dostępu. W przypadku korzystania z uwierzytelniania za pomocą klucza współużytkowanego klucz podstawowy jest używany domyślnie. Aby zmienić klucz do użycia, ustaw właściwość BatchAccountContext.KeyInUse.

Typ:BatchAccountContext
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-CertificateReferences

Określa certyfikaty skojarzone z pulą. Usługa Batch instaluje przywołyne certyfikaty w każdym węźle obliczeniowym puli.

Typ:PSCertificateReference[]
Aliasy:CertificateReference
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-CloudServiceConfiguration

Określa ustawienia konfiguracji puli na podstawie platformy usługi w chmurze platformy Azure.

Typ:PSCloudServiceConfiguration
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-CurrentNodeCommunicationMode

Bieżący tryb komunikacji puli.

Typ:NodeCommunicationMode
Dopuszczalne wartości:Default, Classic, Simplified
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DisplayName

Określa nazwę wyświetlaną puli.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Id

Określa identyfikator puli do utworzenia.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InterComputeNodeCommunicationEnabled

Wskazuje, że to polecenie cmdlet konfiguruje pulę na potrzeby bezpośredniej komunikacji między dedykowanymi węzłami obliczeniowymi.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Metadata

Określa metadane jako pary klucz/wartość, które mają zostać dodane do nowej puli. Klucz jest nazwą metadanych. Wartość to wartość metadanych.

Typ:IDictionary
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MountConfiguration

Lista systemów plików do zainstalowania w każdym węźle w puli. Obsługuje to usługi Azure Files, NFS, CIFS/SMB i Blobfuse.

Typ:PSMountConfiguration[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NetworkConfiguration

Konfiguracja sieci dla puli.

Typ:PSNetworkConfiguration
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResizeTimeout

Określa limit czasu przydzielania węzłów obliczeniowych do puli.

Typ:Nullable<T>[TimeSpan]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceTag

Tagi zdefiniowane przez użytkownika mają być skojarzone z pulą usługi Azure Batch. Po określeniu te tagi są propagowane do zasobów platformy Azure skojarzonych z pulą. Tę właściwość można określić tylko wtedy, gdy konto usługi Batch zostało utworzone za pomocą właściwości poolAllocationMode ustawionej na wartość "UserSubscription".

Typ:IDictionary
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-StartTask

Określa specyfikację zadania uruchamiania dla puli. Zadanie uruchamiania jest uruchamiane, gdy węzeł obliczeniowy dołącza do puli lub gdy węzeł obliczeniowy jest ponownie uruchamiany lub odtwarzany.

Typ:PSStartTask
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetDedicatedComputeNodes

Określa docelową liczbę dedykowanych węzłów obliczeniowych do przydzielenia do puli.

Typ:Nullable<T>[Int32]
Aliasy:TargetDedicated
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetLowPriorityComputeNodes

Określa docelową liczbę węzłów obliczeniowych o niskim priorytcie, które mają być przydzielane do puli.

Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetNodeCommunicationMode

Żądany tryb komunikacji węzła dla puli.

Typ:NodeCommunicationMode
Dopuszczalne wartości:Default, Classic, Simplified
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TaskSchedulingPolicy

Określa zasady planowania zadań, takie jak ComputeNodeFillType.

Typ:PSTaskSchedulingPolicy
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TaskSlotsPerNode

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

Typ:Nullable<T>[Int32]
Aliasy:MaxTasksPerComputeNode
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UpgradePolicy

Zasady uaktualniania puli w NewBatchPoolCommand.cs .

Typ:PSUpgradePolicy
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UserAccount

Lista kont użytkowników do utworzenia w każdym węźle w puli.

Typ:PSUserAccount[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VirtualMachineConfiguration

Określa ustawienia konfiguracji puli w infrastrukturze maszyn wirtualnych.

Typ:PSVirtualMachineConfiguration
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VirtualMachineSize

Określa rozmiar maszyn wirtualnych w puli. Aby uzyskać więcej informacji na temat rozmiarów maszyn wirtualnych, zobacz Rozmiary maszyn wirtualnych w witrynie platformy Microsoft Azure.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

BatchAccountContext

Dane wyjściowe

Void