Start-AzAutomationRunbook

  • Riferimento
Modulo:
Az.Automation

Avvia un processo del runbook.

Sintassi

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>]

Descrizione

Il cmdlet Start-AzAutomationRunbook avvia un processo runbook Automazione di Azure. Specificare l'ID o il nome di un runbook.

Esempio

Esempio 1: Avviare un processo del runbook

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

Questo comando avvia un processo del runbook per il runbook denominato Runbk01 nell'account Automazione di Azure denominato Contoso17.

Esempio 2: Avviare un processo runbook Python 2 con parametri

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

Questo comando avvia un processo del runbook per il runbook Python 2 denominato RunbkPy01 nell'account Automazione di Azure denominato Contoso17 con "ValueForPosition1" come primo parametro posizionale e "ValueForPosition2" per il secondo.

Esempio 3: Avviare un processo del runbook e attendere i risultati

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

Questo comando avvia un processo del runbook per il runbook denominato Runbk01 nell'account Automazione di Azure denominato Contoso17. Questo comando specifica il parametro Wait . Pertanto, restituisce i risultati dopo il completamento del processo. Il cmdlet attende fino a 1000 secondi per i risultati.

Parametri

-AutomationAccountName

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MaxWaitSeconds

Specifica il numero di secondi in cui il cmdlet attende il completamento di un processo prima di abbandonare il processo. Il valore predefinito è 10800 o tre ore.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Tipo:String
Alias:RunbookName
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Parameters

Tipo:IDictionary
Alias:JobParameters
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceGroupName

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RunOn

Specifica il gruppo di ruoli di lavoro ibridi in cui eseguire il runbook.

Tipo:String
Alias:HybridWorker
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Wait

Indica che questo cmdlet attende il completamento, la sospensione o l'esito negativo del processo e quindi restituisce il controllo ad Azure PowerShell.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

Output

Job

PSObject