Sdílet prostřednictvím


Start-AzAutomationRunbook

Spustí úlohu runbooku.

Syntax

ByAsynchronousReturnJob (Výchozí)

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

BySynchronousReturnJobOutput

Start-AzAutomationRunbook
    [-Name] <String>
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    [-Parameters <IDictionary>]
    [-RunOn <String>]
    [-Wait]
    [-MaxWaitSeconds <Int32>]
    [-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

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:1
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-DefaultProfile

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

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:Int32
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

BySynchronousReturnJobOutput
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Name

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:RunbookName

Sady parametrů

(All)
Position:2
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Parameters

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

Vlastnosti parametru

Typ:IDictionary
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:JobParameters

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ResourceGroupName

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-RunOn

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:HybridWorker

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Wait

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

BySynchronousReturnJobOutput
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Výstupy

Job

PSObject