Sdílet prostřednictvím

Start-AzAutomationRunbook

  • Reference
Modul:
Az.Automation

Spustí úlohu runbooku.

Syntaxe

Start-AzAutomationRunbook
     [-Name] <String>
     [-Parameters <IDictionary>]
     [-RunOn <String>]
     [-ResourceGroupName] <String>
     [-AutomationAccountName] <String>
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]
Start-AzAutomationRunbook
     [-Name] <String>
     [-Parameters <IDictionary>]
     [-RunOn <String>]
     [-Wait]
     [-MaxWaitSeconds <Int32>]
     [-ResourceGroupName] <String>
     [-AutomationAccountName] <String>
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]

Description

Rutina Start-AzAutomationRunbook spustí úlohu runbooku Azure Automation. Zadejte ID nebo název runbooku.

Příklady

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

Start-AzAutomationRunbook -AutomationAccountName "Contoso17" -Name "Runbk01" -ResourceGroupName "ResourceGroup01"

Tento příkaz spustí úlohu runbooku pro runbook s názvem Runbk01 v účtu Azure Automation s názvem Contoso17.

Příklad 2: Spuštění úlohy runbooku Python 2 s parametry

$params = [ordered]@{"Key1"="ValueForPosition1";"Key2"="ValueForPosition2"}
Start-AzAutomationRunbook -AutomationAccountName "Contoso17" -Name "RunbkPy01" -ResourceGroupName "ResourceGroup01" -Parameters $params

Tento příkaz spustí úlohu runbooku pro runbook Python 2 s názvem RunbkPy01 v účtu Azure Automation s názvem "ValueForPosition1" jako prvním pozičním parametrem a hodnotou ValueForPosition2 pro druhý.

Příklad 3: Spuštění úlohy runbooku a čekání na výsledky

Start-AzAutomationRunbook -AutomationAccountName "Contoso17" -Name "Runbk01" -ResourceGroupName "ResourceGroup01" -MaxWaitSeconds 1000 -Wait

Tento příkaz spustí úlohu runbooku pro runbook s názvem Runbk01 v účtu Azure Automation s názvem Contoso17. Tento příkaz určuje parametr Wait. Proto po dokončení úlohy vrátí výsledky. Rutina počká až 1 000 sekund na výsledky.

Parametry

-AutomationAccountName

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaxWaitSeconds

Určuje počet sekund, po které tato rutina čeká na dokončení úlohy, než úlohu opustí. Výchozí hodnota je 10800 nebo tři hodiny.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Typ:String
Aliasy:RunbookName
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Parameters

Typ:IDictionary
Aliasy:JobParameters
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RunOn

Určuje, ve které skupině Hybrid Worker se má runbook spustit.

Typ:String
Aliasy:HybridWorker
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Wait

Označuje, že tato rutina čeká na dokončení, pozastavení nebo selhání úlohy a vrátí řízení do Azure PowerShellu.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Výstupy

Job

PSObject