Start-AzAutomationRunbook

Référence

Module:: Az.Automation

Démarre un travail de runbook.

Syntax

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

L’applet de commande Start-AzAutomationRunbook démarre une tâche de runbook Azure Automation. Spécifiez l’ID ou le nom d’un runbook.

Exemples

Exemple 1 : Démarrer un travail de runbook

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

Cette commande démarre un travail de runbook pour le runbook nommé Runbk01 dans le compte Azure Automation nommé Contoso17.

Exemple 2 : Démarrer un travail de runbook Python 2 avec des paramètres

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

Cette commande démarre un travail de runbook pour le runbook Python 2 nommé RunbkPy01 dans le compte Azure Automation nommé Contoso17 avec « ValueForPosition1 » comme premier paramètre positionnel et « ValueForPosition2 » pour le deuxième.

Exemple 3 : Démarrer un travail de runbook et attendre les résultats

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

Cette commande démarre un travail de runbook pour le runbook nommé Runbk01 dans le compte Azure Automation nommé Contoso17. Cette commande spécifie le paramètre Wait . Par conséquent, il retourne les résultats une fois le travail terminé. L’applet de commande attend jusqu’à 1 000 secondes pour les résultats.

Paramètres

-AutomationAccountName

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

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxWaitSeconds

Spécifie le nombre de secondes pendant lesquelles cette applet de commande attend la fin d’un travail avant d’abandonner le travail. La valeur par défaut est 10800 ou trois heures.

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

Spécifie le groupe worker hybride sur lequel exécuter le runbook.

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

-Wait

Indique que cette applet de commande attend la fin, la suspension ou l’échec du travail, puis retourne le contrôle à Azure PowerShell.

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

Entrées

String

Sorties

Job

PSObject