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

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

-DefaultProfile

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

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

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

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

Type:String
Aliases:HybridWorker
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

Input

String

Output

Job

PSObject