Start-Job

Reference

Modul:: Microsoft.PowerShell.Core

Spustí úlohu PowerShellu na pozadí.

Syntax

Start-Job
     [-Name <String>]
     [-ScriptBlock] <ScriptBlock>
     [-Credential <PSCredential>]
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-RunAs32]
     [-PSVersion <Version>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [<CommonParameters>]

Start-Job
     [-DefinitionName] <String>
     [[-DefinitionPath] <String>]
     [[-Type] <String>]
     [<CommonParameters>]

Start-Job
     [-Name <String>]
     [-Credential <PSCredential>]
     [-FilePath] <String>
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-RunAs32]
     [-PSVersion <Version>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [<CommonParameters>]

Start-Job
     [-Name <String>]
     [-Credential <PSCredential>]
     -LiteralPath <String>
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-RunAs32]
     [-PSVersion <Version>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [<CommonParameters>]

Description

Rutina Start-Job spustí úlohu prostředí PowerShell na pozadí na místním počítači.

Úloha na pozadí PowerShellu spustí příkaz bez interakce s aktuální relací. Když spustíte úlohu na pozadí, objekt úlohy se vrátí okamžitě, i když dokončení úlohy trvá delší dobu. Během spuštění úlohy můžete pokračovat v práci v relaci bez přerušení.

Objekt úlohy obsahuje užitečné informace o úloze, ale neobsahuje výsledky úlohy. Po dokončení úlohy pomocí Receive-Job rutiny získejte výsledky úlohy. Další informace o úlohách na pozadí najdete v tématu about_Jobs.

Pokud chcete spustit úlohu na pozadí na vzdáleném počítači, použijte parametr AsJob , který je k dispozici v mnoha rutinách, nebo pomocí rutiny Invoke-Command spusťte Start-Job příkaz na vzdáleném počítači. Další informace najdete v tématu about_Remote_Jobs.

Počínaje PowerShellem 3.0 Start-Job můžete spustit instance vlastních typů úloh, jako jsou naplánované úlohy. Informace o tom, jak spouštět Start-Job úlohy s vlastními typy, najdete v dokumentech nápovědy pro funkci typu úlohy.

Výchozí pracovní adresář pro úlohy je pevně zakódovaný. Výchozí nastavení windows je $HOME\Documents a v Linuxu nebo macOS je $HOMEvýchozí hodnota . Kód skriptu spuštěný v úloze na pozadí musí podle potřeby spravovat pracovní adresář.

Příklady

Příklad 1: Spuštění úlohy na pozadí

Tento příklad spustí úlohu na pozadí, která běží na místním počítači.

Start-Job -ScriptBlock { Get-Process -Name powershell }

Id  Name   PSJobTypeName   State     HasMoreData   Location    Command
--  ----   -------------   -----     -----------   --------    -------
1   Job1   BackgroundJob   Running   True          localhost   Get-Process -Name powershell

Start-Jobpoužívá parametr ScriptBlock ke spuštění Get-Process jako úlohu na pozadí. Parametr Name určuje, jak najít procesy PowerShellu. powershell Zobrazí se informace o úloze a PowerShell se vrátí k příkazovému řádku, zatímco úloha běží na pozadí.

Pokud chcete zobrazit výstup úlohy, použijte rutinu Receive-Job . Například Receive-Job -Id 1.

Příklad 2: Spuštění úlohy pomocí příkazu Invoke-Command

Tento příklad spustí úlohu na více počítačích. Úloha se uloží do proměnné a spustí se pomocí názvu proměnné na příkazovém řádku PowerShellu.

$jobWRM = Invoke-Command -ComputerName (Get-Content -Path C:\Servers.txt) -ScriptBlock {
   Get-Service -Name WinRM } -JobName WinRM -ThrottleLimit 16 -AsJob

Úloha, která používá Invoke-Command , se vytvoří a uloží do $jobWRM proměnné. Invoke-Command pomocí parametru ComputerName určí počítače, ve kterých se úloha spouští. Get-Content získá názvy serverů ze C:\Servers.txt souboru.

Parametr ScriptBlock určuje příkaz, který Get-Service získá službu WinRM . Parametr JobName určuje popisný název úlohy, WinRM. Parametr ThrottleLimit omezuje počet souběžných příkazů na 16. Parametr AsJob spustí úlohu na pozadí, která spustí příkaz na serverech.

Příklad 3: Získání informací o úloze

Tento příklad získá informace o úloze a zobrazí výsledky dokončené úlohy, která byla spuštěna v místním počítači.

$j = Start-Job -ScriptBlock { Get-WinEvent -Log System } -Credential Domain01\User01
$j | Select-Object -Property *

State         : Completed
HasMoreData   : True
StatusMessage :
Location      : localhost
Command       : Get-WinEvent -Log System
JobStateInfo  : Completed
Finished      : System.Threading.ManualResetEvent
InstanceId    : 27ce3fd9-40ed-488a-99e5-679cd91b9dd3
Id            : 18
Name          : Job18
ChildJobs     : {Job19}
PSBeginTime   : 8/8/2019 14:41:57
PSEndTime     : 8/8/2019 14:42:07
PSJobTypeName : BackgroundJob
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
Information   : {}

Start-Jobpomocí parametru ScriptBlock spustí příkaz, který určuje Get-WinEvent získání systémového protokolu. Parametr Credential určuje uživatelský účet domény s oprávněním ke spuštění úlohy v počítači. Objekt úlohy je uložen v $j proměnné.

Objekt v $j proměnné se odešle do kanálu do Select-Object. Parametr Property určuje hvězdičku (*) pro zobrazení všech vlastností objektu úlohy.

Příklad 4: Spuštění skriptu jako úlohy na pozadí

V tomto příkladu se skript na místním počítači spustí jako úloha na pozadí.

Start-Job -FilePath C:\Scripts\Sample.ps1

Start-Jobpoužívá parametr FilePath k určení souboru skriptu, který je uložen v místním počítači.

Příklad 5: Získání procesu pomocí úlohy na pozadí

Tento příklad používá úlohu na pozadí k získání zadaného procesu podle názvu.

Start-Job -Name PShellJob -ScriptBlock { Get-Process -Name PowerShell }

Start-Job pomocí parametru Name určuje popisný název úlohy PShellJob. Parametr ScriptBlock určuje Get-Process , že se mají procesy načíst s názvem PowerShellu.

Příklad 6: Shromažďování a ukládání dat pomocí úlohy na pozadí

Tento příklad spustí úlohu, která shromažďuje velké množství mapových dat a pak je uloží do .tif souboru.

Start-Job -Name GetMappingFiles -InitializationScript {Import-Module -Name MapFunctions} -ScriptBlock {
   Get-Map -Name * | Set-Content -Path D:\Maps.tif } -RunAs32

Start-Jobpoužívá parametr Name k zadání popisného názvu úlohy GetMappingFiles. Parametr InitializationScript spustí blok skriptu, který importuje modul MapFunctions . Parametr ScriptBlock se spustí Get-Map a Set-Content uloží data do umístění určeného parametrem Path . Parametr RunAs32 spustí proces jako 32bitový, dokonce i v 64bitovém operačním systému.

Příklad 7: Předání vstupu do úlohy na pozadí

Tento příklad používá automatickou $input proměnnou ke zpracování vstupního objektu. Slouží Receive-Job k zobrazení výstupu úlohy.

Start-Job -ScriptBlock { Get-Content -Path $input } -InputObject "C:\Servers.txt"
Receive-Job -Name Job45 -Keep

Server01
Server02
Server03
Server04

Start-Job používá parametr ScriptBlock ke spuštění Get-Content s automatickou proměnnou $input . Proměnná $input získá objekty z InputObject parametru. Receive-Jobpoužije parametr Name k určení úlohy a výstupu výsledků. Parametr Keep uloží výstup úlohy, aby ho bylo možné znovu zobrazit během relace PowerShellu.

Příklad 8: Určení pole pomocí parametru ArgumentList

Tento příklad používá argumentList parametr k určení pole argumentů. Pole je čárkami oddělený seznam názvů procesů.

Start-Job -ScriptBlock { Get-Process -Name $args } -ArgumentList powershell, pwsh, notepad

Id     Name      PSJobTypeName   State       HasMoreData     Location     Command
--     ----      -------------   -----       -----------     --------     -------
1      Job1      BackgroundJob   Running     True            localhost    Get-Process -Name $args

Rutina Start-Job ke spuštění příkazu používá parametr ScriptBlock . Get-Processpoužívá parametr Name k určení automatické proměnné $args. Parametr ArgumentList předá pole názvů procesů .$args Názvy procesů powershellu, pwsh a poznámkového bloku jsou procesy spuštěné v místním počítači.

Pokud chcete zobrazit výstup úlohy, použijte rutinu Receive-Job . Například Receive-Job -Id 1.

Parametry

-ArgumentList

Určuje pole argumentů nebo hodnot parametrů pro skript určený parametrem FilePath nebo příkazem zadaným parametrem ScriptBlock .

Argumenty musí být předány argumentu ArgumentList jako argument pole s jednou dimenzí. Například seznam oddělený čárkami. Další informace o chování ArgumentList naleznete v tématu about_Splatting.

Type:	Object[]
Aliases:	Args
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Authentication

Určuje mechanismus, který se používá k ověření přihlašovacích údajů uživatele.

Přijatelné hodnoty pro tento parametr jsou následující:

Výchozí
Basic
Credssp
Digest
Kerberos
Vyjednávat
NegotiateWithImplicitCredential

Výchozí hodnota je Default.

Ověřování CredSSP je k dispozici pouze v systémech Windows Vista, Windows Server 2008 a novějších verzích operačního systému Windows.

Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationMechanism.

Upozornění

Ověřování zprostředkovatele podpory zabezpečení přihlašovacích údajů (CredSSP), ve kterém jsou přihlašovací údaje uživatele předány vzdálenému počítači, který se má ověřit, je určený pro příkazy, které vyžadují ověření u více než jednoho prostředku, například pro přístup ke vzdálené síťové sdílené složce. Tento mechanismus zvyšuje riziko zabezpečení vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, dají se k řízení síťové relace použít přihlašovací údaje, které jsou mu předány.

Type:	AuthenticationMechanism
Accepted values:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:	Named
Default value:	Default
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Určuje uživatelský účet, který má oprávnění k provedení této akce. Pokud není zadaný parametr Credential, příkaz použije přihlašovací údaje aktuálního uživatele.

Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential vygenerovaný rutinouGet-Credential. Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.

Přihlašovací údaje jsou uloženy v objektu PSCredential a heslo je uloženo jako SecureString.

Poznámka:

Další informace o ochraně dat SecureString naleznete v tématu Jak zabezpečený je SecureString?.

Type:	PSCredential
Position:	Named
Default value:	Current user
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefinitionName

Určuje název definice úlohy, kterou tato rutina spustí. Tento parametr použijte ke spuštění vlastních typů úloh, které mají název definice, například naplánované úlohy.

Když použijete Start-Job ke spuštění instance naplánované úlohy, úloha se spustí okamžitě bez ohledu na aktivační události úlohy nebo možnosti úlohy. Výsledná instance úlohy je naplánovaná úloha, ale neuloží se na disk, jako jsou aktivované naplánované úlohy. Parametr ArgumentListStart-Job nelze použít k zadání hodnot parametrů skriptů, které se spouští v naplánované úloze. Další informace najdete v tématu about_Scheduled_Jobs.

Tento parametr byl představen v PowerShellu 3.0.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefinitionPath

Určuje cestu definice úlohy, kterou tato rutina spustí. Zadejte cestu definice. Zřetězení hodnot parametrů DefinitionPath a DefinitionName je plně kvalifikovaná cesta definice úlohy. Tento parametr použijte ke spuštění vlastních typů úloh, které mají cestu definice, například naplánované úlohy.

U plánovaných úloh je $HOME\AppData\Local\Windows\PowerShell\ScheduledJobhodnota parametru DefinitionPath .

Tento parametr byl představen v PowerShellu 3.0.

Type:	String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FilePath

Určuje místní skript, který Start-Job se spouští jako úloha na pozadí. Zadejte cestu a název souboru skriptu nebo použijte kanál k odeslání cesty Start-Jobke skriptu . Skript musí být v místním počítači nebo ve složce, ke které má místní počítač přístup.

Při použití tohoto parametru PowerShell převede obsah zadaného souboru skriptu na blok skriptu a spustí blok skriptu jako úlohu na pozadí.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InitializationScript

Určuje příkazy, které se spustí před spuštěním úlohy. Pokud chcete vytvořit blok skriptu, uzavřete příkazy do složených závorek ({}).

Tento parametr použijte k přípravě relace, ve které se úloha spouští. Můžete ho například použít k přidání funkcí, modulů snap-in a do relace.

Type:	ScriptBlock
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Určuje vstup pro příkaz. Zadejte proměnnou, která obsahuje objekty, nebo zadejte příkaz nebo výraz, který generuje objekty.

V hodnotě ScriptBlock parametru použijte $input automatickou proměnnou k reprezentaci vstupních objektů.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LiteralPath

Určuje místní skript, který tato rutina spustí jako úlohu na pozadí. Zadejte cestu ke skriptu v místním počítači.

Start-Job používá hodnotu parametru LiteralPath přesně tak, jak je zadán. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby nepřekládaly žádné znaky jako řídicí sekvence.

Type:	String
Aliases:	PSPath
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Určuje popisný název nové úlohy. Název můžete použít k identifikaci úlohy pro jiné rutiny úloh, jako je například rutina Stop-Job .

Výchozí popisný název je Job#, kde # je pořadové číslo, které se pro každou úlohu zvýší.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PSVersion

Určuje verzi. Start-Job spustí úlohu s verzí PowerShellu. Přijatelné hodnoty pro tento parametr jsou: 2.0 a 3.0.

Tento parametr byl představen v PowerShellu 3.0.

Type:	Version
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAs32

Označuje, že Start-Job se úloha spouští v 32bitovém procesu. RunAs32 vynutí spuštění úlohy v 32bitovém procesu i v 64bitovém operačním systému.

V 64bitových verzích Systémů Windows 7 a Windows Server 2008 R2 platí, že pokud Start-Job příkaz obsahuje parametr RunAs32 , nemůžete k zadání přihlašovacích údajů jiného uživatele použít parametr Credential .

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptBlock

Určuje příkazy, které se mají spustit v úloze na pozadí. Pokud chcete vytvořit blok skriptu, uzavřete příkazy do složených závorek ({}). $input Pro přístup k hodnotě parametru InputObject použijte automatickou proměnnou. Tento parametr je povinný.

Type:	ScriptBlock
Aliases:	Command
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

Určuje vlastní typ pro úlohy spuštěné pomocí Start-Job. Zadejte název vlastního typu úlohy, například PSScheduledJob pro naplánované úlohy nebo PSWorkflowJob pro úlohy pracovních postupů. Tento parametr není platný pro standardní úlohy na pozadí.

Tento parametr byl představen v PowerShellu 3.0.

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Vstupy

String

Objekt můžete do této rutiny převést pomocí vlastnosti Name do parametru Name . Můžete například přát objekt FileInfo z Get-ChildItem.

Výstupy

System.Management.Automation.PSRemotingJob

Tato rutina vrátí objekt PSRemotingJob představující úlohu, kterou spustil.

Poznámky

Windows PowerShell obsahuje následující aliasy pro Start-Job:

sajb

Pokud chcete spustit na pozadí, Start-Job spustí se ve své vlastní relaci v aktuální relaci. Když použijete rutinu Invoke-CommandStart-Job ke spuštění příkazu v relaci na vzdáleném počítači, Start-Job spustí se relace ve vzdálené relaci.

Sdílet prostřednictvím

Start-Job

Syntax

Description

Příklady

Příklad 1: Spuštění úlohy na pozadí

Příklad 2: Spuštění úlohy pomocí příkazu Invoke-Command

Příklad 3: Získání informací o úloze

Příklad 4: Spuštění skriptu jako úlohy na pozadí

Příklad 5: Získání procesu pomocí úlohy na pozadí

Příklad 6: Shromažďování a ukládání dat pomocí úlohy na pozadí

Příklad 7: Předání vstupu do úlohy na pozadí

Příklad 8: Určení pole pomocí parametru ArgumentList

Parametry

-ArgumentList

-Authentication

-Credential

-DefinitionName

-DefinitionPath

-FilePath

-InitializationScript

-InputObject

-LiteralPath

-Name

-PSVersion

-RunAs32

-ScriptBlock

-Type

Vstupy

Výstupy

Poznámky

Další materiály

Sdílet prostřednictvím

Start-Job

Syntax

Description

Příklady

Příklad 1: Spuštění úlohy na pozadí

Příklad 2: Spuštění úlohy pomocí příkazu Invoke-Command

Příklad 3: Získání informací o úloze

Příklad 4: Spuštění skriptu jako úlohy na pozadí

Příklad 5: Získání procesu pomocí úlohy na pozadí

Příklad 6: Shromažďování a ukládání dat pomocí úlohy na pozadí

Příklad 7: Předání vstupu do úlohy na pozadí

Příklad 8: Určení pole pomocí parametru ArgumentList

Parametry

-ArgumentList

-Authentication

-Credential

-DefinitionName

-DefinitionPath

-FilePath

-InitializationScript

-InputObject

-LiteralPath

-Name

-PSVersion

-RunAs32

-ScriptBlock

-Type

Vstupy

Výstupy

Poznámky

Související odkazy

Další materiály