Sdílet prostřednictvím

Start-AzureRMAutomationRunbook

  • Reference
Modul:
AzureRM.Automation

Spustí úlohu runbooku.

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntax

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

Description

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

Příklady

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

PS C:\>Start-AzureRmAutomationRunbook -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 a čekání na výsledky

Start-AzureRmAutomationRunbook -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

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Name

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

-Parameters

Type:IDictionary
Aliases:JobParameters
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

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

-RunOn

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

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

-Wait

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

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

Vstupy

String

Výstupy

Job

-Tato rutina vrátí objekt Úlohy , pokud nezadáte parametr Wait . -Pokud nezadáte wait, Azure PowerShell okamžitě vrátí objekt úlohy . -Pokud zadáte wait, Azure PowerShell dokončí úlohu a vrátí výsledek. -Výsledek není objektem úlohy .

PSObject