New-AzBatchTask
Batch-feladatot hoz létre egy feladat alatt.
Syntax
New-AzBatchTask
-JobId <String>
-Id <String>
[-DisplayName <String>]
-CommandLine <String>
[-ResourceFiles <PSResourceFile[]>]
[-EnvironmentSettings <IDictionary>]
[-AuthenticationTokenSettings <PSAuthenticationTokenSettings>]
[-UserIdentity <PSUserIdentity>]
[-AffinityInformation <PSAffinityInformation>]
[-Constraints <PSTaskConstraints>]
[-MultiInstanceSettings <PSMultiInstanceSettings>]
[-DependsOn <TaskDependencies>]
[-ApplicationPackageReferences <PSApplicationPackageReference[]>]
[-OutputFile <PSOutputFile[]>]
[-ExitConditions <PSExitConditions>]
[-ContainerSettings <PSTaskContainerSettings>]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzBatchTask
-JobId <String>
[-Tasks <PSCloudTask[]>]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzBatchTask
[-Job <PSCloudJob>]
[-Tasks <PSCloudTask[]>]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzBatchTask
[-Job <PSCloudJob>]
-Id <String>
[-DisplayName <String>]
-CommandLine <String>
[-ResourceFiles <PSResourceFile[]>]
[-EnvironmentSettings <IDictionary>]
[-AuthenticationTokenSettings <PSAuthenticationTokenSettings>]
[-UserIdentity <PSUserIdentity>]
[-AffinityInformation <PSAffinityInformation>]
[-Constraints <PSTaskConstraints>]
[-MultiInstanceSettings <PSMultiInstanceSettings>]
[-DependsOn <TaskDependencies>]
[-ApplicationPackageReferences <PSApplicationPackageReference[]>]
[-OutputFile <PSOutputFile[]>]
[-ExitConditions <PSExitConditions>]
[-ContainerSettings <PSTaskContainerSettings>]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
A New-AzBatchTask parancsmag létrehoz egy Azure Batch-feladatot a JobId paraméter vagy a Feladat paraméter által megadott feladat alatt.
Példák
1. példa: Batch-feladat létrehozása
New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -BatchContext $Context
Ez a parancs létrehoz egy feladatot, amely a Feladat-000001 azonosítójú feladat alatt található 23. tevékenységazonosítóval rendelkezik. A feladat a megadott parancsot futtatja. A Get-AzBatchAccountKey parancsmaggal környezeteket rendelhet a $Context változóhoz.
2. példa: Batch-feladat létrehozása
$autoUser = New-Object Microsoft.Azure.Commands.Batch.Models.PSAutoUserSpecification -ArgumentList @("Task", "Admin")
$userIdentity = New-Object Microsoft.Azure.Commands.Batch.Models.PSUserIdentity $autoUser
Get-AzBatchJob -Id "Job-000001" -BatchContext $Context | New-AzBatchTask -Id "Task26" -CommandLine "cmd /c echo hello > newFile.txt" -UserIdentity $userIdentity -BatchContext $Context
Ez a parancs a Get-AzBatchJob parancsmaggal lekéri a 000001 azonosítójú Batch-feladatot. A parancs a folyamatkezelővel továbbítja a feladatot az aktuális parancsmagnak. A parancs létrehoz egy feladatot, amely a feladat alatt található Task26 azonosítóval rendelkezik. A feladat emelt szintű engedélyekkel futtatja a megadott parancsot.
3. példa: Tevékenységek gyűjteményének hozzáadása a megadott feladathoz a folyamat használatával
$Context = Get-AzBatchAccountKey -AccountName "ContosoBatchAccount"
$Task01 = New-Object Microsoft.Azure.Commands.Batch.Models.PSCloudTask("Task23", "cmd /c dir /s")
$Task02 = New-Object Microsoft.Azure.Commands.Batch.Models.PSCloudTask("Task24", "cmd /c dir /s")
Get-AzBatchJob -Id "Job-000001" -BatchContext $Context | New-AzBatchTask -Tasks @($Task01, $Task02) -BatchContext $Context
Az első parancs objektumhivatkozást hoz létre a ContosoBatchAccount nevű batch-fiók fiókkulcsaira a Get-AzBatchAccountKey használatával. A parancs ezt az objektumhivatkozást a $Context változóban tárolja. A következő két parancs PSCloudTask-objektumokat hoz létre a New-Object parancsmag használatával. A parancsok a $Task 01 és $Task 02 változókban tárolják a feladatokat. Az utolsó parancs lekéri a 000001 azonosítójú Batch-feladatot a Get-AzBatchJob használatával. Ezután a parancs átadja a feladatot az aktuális parancsmagnak a folyamatkezelő használatával. A parancs feladatgyűjteményt ad hozzá a feladathoz. A parancs a $Context tárolt környezetet használja.
4. példa: Tevékenységek gyűjteményének hozzáadása a megadott feladathoz
$Context = Get-AzBatchAccountKey -AccountName "ContosoBatchAccount"
$Task01 = New-Object Microsoft.Azure.Commands.Batch.Models.PSCloudTask("Task23", "cmd /c dir /s")
$Task02 = New-Object Microsoft.Azure.Commands.Batch.Models.PSCloudTask("Task24", "cmd /c dir /s")
New-AzBatchTask -JobId "Job-000001" -Tasks @($Task01, $Task02) -BatchContext $Context
Az első parancs objektumhivatkozást hoz létre a ContosoBatchAccount nevű batch-fiók fiókkulcsaira a Get-AzBatchAccountKey használatával. A parancs ezt az objektumhivatkozást a $Context változóban tárolja. A következő két parancs PSCloudTask-objektumokat hoz létre a New-Object parancsmag használatával. A parancsok a $Task 01 és $Task 02 változókban tárolják a feladatokat. Az utolsó parancs hozzáadja a $Task 01-ben és $Task 02-ben tárolt feladatokat a Job-000001 azonosítójú feladathoz.
5. példa: Feladat hozzáadása kimeneti fájlokkal
New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -BatchContext $Context
$blobContainerDestination = New-Object Microsoft.Azure.Commands.Batch.Models.PSOutputFileBlobContainerDestination "https://myaccount.blob.core.windows.net/sascontainer?sv=2015-04-05&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=Z%2FRHIX5Xcg0Mq2rqI3OlWTjEg2tYkboXr1P9ZUXDtkk%3D"
$destination = New-Object Microsoft.Azure.Commands.Batch.Models.PSOutputFileDestination $blobContainerDestination
$uploadOptions = New-Object Microsoft.Azure.Commands.Batch.Models.PSOutputFileUploadOptions "TaskSuccess"
$outputFile = New-Object Microsoft.Azure.Commands.Batch.Models.PSOutputFile "*.txt", $blobContainerDestination, $uploadOptions
New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -OutputFile $outputFile -BatchContext $Context
6. példa: Feladat hozzáadása hitelesítési jogkivonat-beállításokkal
$authSettings = New-Object Microsoft.Azure.Commands.Batch.Models.PSAuthenticationTokenSettings
$authSettings.Access = "Job"
New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -AuthenticationTokenSettings $authSettings -BatchContext $Context
7. példa: Tárolóban futó feladat hozzáadása
$Context = Get-AzBatchAccountKey -AccountName "ContosoBatchAccount"
New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -ContainerSettings (New-Object Microsoft.Azure.Commands.Batch.Models.PSTaskContainerSettings "containerImageName") -BatchContext $Context
Paraméterek
-AffinityInformation
Megadja a Batch szolgáltatás által a feladat futtatásához használt csomópont kiválasztásához használt területi tippet.
Típus: | PSAffinityInformation |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ApplicationPackageReferences
Típus: | PSApplicationPackageReference[] |
Aliasok: | ApplicationPackageReference |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-AuthenticationTokenSettings
Egy hitelesítési jogkivonat beállításai, amelyeket a feladat a Batch szolgáltatásműveletek végrehajtásához használhat. Ha ez be van állítva, a Batch szolgáltatás egy hitelesítési jogkivonatot biztosít a feladatnak, amely a Batch szolgáltatás műveleteinek hitelesítéséhez használható fiókhozzáférési kulcs megkövetelése nélkül. A jogkivonatot a AZ_BATCH_AUTHENTICATION_TOKEN környezeti változó biztosítja. A tevékenység által a jogkivonat használatával végrehajtott műveletek a beállításoktól függenek. Egy tevékenység például kérheti a feladat engedélyeit, hogy más tevékenységeket vegyen fel a feladatba, vagy ellenőrizze a feladat vagy más tevékenységek állapotát.
Típus: | PSAuthenticationTokenSettings |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-BatchContext
Megadja azt a BatchAccountContext-példányt , amelyet ez a parancsmag a Batch szolgáltatással való interakcióhoz használ. Ha a Get-AzBatchAccount parancsmagot használja a BatchAccountContext lekéréséhez, akkor a Microsoft Entra-hitelesítés lesz használva a Batch szolgáltatással való interakció során. A megosztott kulcsos hitelesítés használatához használja a Get-AzBatchAccountKey parancsmagot egy BatchAccountContext objektum lekéréséhez a hozzáférési kulcsok kitöltésével. Megosztott kulcsú hitelesítés használatakor alapértelmezés szerint az elsődleges hozzáférési kulcsot használja a rendszer. A használni kívánt kulcs módosításához állítsa be a BatchAccountContext.KeyInUse tulajdonságot.
Típus: | BatchAccountContext |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-CommandLine
Megadja a feladat parancssorát.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Constraints
Megadja a tevékenységre vonatkozó végrehajtási korlátozásokat.
Típus: | PSTaskConstraints |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ContainerSettings
Annak a tárolónak a beállításai, amelyek alatt a feladat fut. Ha a feladatot futtató készlet tárolókonfigurációs készlettel rendelkezik, ezt is be kell állítani. Ha a feladatot futtató készlet nem rendelkezik tárolókonfigurációval, ezt nem szabad beállítani. Ha ez meg van adva, a rendszer a AZ_BATCH_NODE_ROOT_DIR alatt rekurzívan az összes könyvtárat (a csomóponton található Azure Batch-címtárak gyökerét) leképezi a tárolóba, az összes tevékenységkörnyezeti változót a tárolóba rendeli, és a feladat parancssora a tárolóban lesz végrehajtva.
Típus: | PSTaskContainerSettings |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Típus: | IAzureContextContainer |
Aliasok: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DependsOn
Azt adja meg, hogy a tevékenység más tevékenységektől függ. A tevékenység csak akkor lesz ütemezve, ha az összes függő tevékenység sikeresen befejeződött.
Típus: | TaskDependencies |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DisplayName
Megadja a feladat megjelenítendő nevét.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-EnvironmentSettings
Megadja azokat a környezeti beállításokat kulcs/érték párként, amelyeket ez a parancsmag hozzáad a tevékenységhez. A kulcs a környezeti beállítás neve. Az érték a környezeti beállítás.
Típus: | IDictionary |
Aliasok: | EnvironmentSetting |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ExitConditions
Típus: | PSExitConditions |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Id
Megadja a tevékenység azonosítóját.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Job
Megadja azt a feladatot, amely alatt ez a parancsmag létrehozza a feladatot. PSCloudJob-objektum beszerzéséhez használja a Get-AzBatchJob parancsmagot.
Típus: | PSCloudJob |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-JobId
Annak a feladatnak az azonosítóját adja meg, amely alatt ez a parancsmag létrehozza a feladatot.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-MultiInstanceSettings
A többpéldányos feladatok futtatásával kapcsolatos információkat adja meg.
Típus: | PSMultiInstanceSettings |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-OutputFile
Lekéri vagy beállítja azon fájlok listáját, amelyeket a Batch szolgáltatás feltölt a számítási csomópontról a parancssor futtatása után. Többpéldányos tevékenységek esetén a fájlok csak abból a számítási csomópontból lesznek feltöltve, amelyen az elsődleges tevékenység végrehajtásra kerül.
Típus: | PSOutputFile[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ResourceFiles
A feladat által igényelt erőforrásfájlokat kulcs/érték párként adja meg. A kulcs az erőforrásfájl elérési útja. Az érték az erőforrásfájl blobforrása.
Típus: | PSResourceFile[] |
Aliasok: | ResourceFile |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Tasks
Megadja a hozzáadni kívánt tevékenységek gyűjteményét. Minden tevékenységnek egyedi azonosítóval kell rendelkeznie.
Típus: | PSCloudTask[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-UserIdentity
A felhasználói identitás, amely alatt a feladat fut.
Típus: | PSUserIdentity |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
Kimenetek
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: